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PREFACE 

This manual describes the OASIS Operating System and provides the detailed 
information necessary to use the operating system, utility programs, file 
management, user accounting, etc. 

This manual, named SYSREF, like all OASIS documentation manuals, has the manual 
name and revision number in the lower, inside corner of each page of the body of 
the manual. In most chapters of the manual the last primary subject being 
discussed on a page will be identified in the lower outside corner of the page. 

I This manual describes some features that are only available with the multi-user 

( version of the OASIS operating system. For documentation purposes, any information 

j that pertains to multi-user only will be denoted by the vertical bar character in 

j both margins, similar to this paragraph. 

I 

Version Kuabers 

All OASIS operating systems and command programs have version numbers. The version 
number of the operating system is displayed each time that the system is booted. 
The version ^siber of programs may be determined by using the SET command to turn 
the version display on. It is important for you to know the version of your system 
and its programs in case there is any difficulty and you have to communicate with 
your distributor. 

All OASIS reference manuals also have version numbers. The version number of a 
manual is displayed on the title page, i.e.. Second Edition. It is possible that a 
manual may be revised- When this is the case the manual will have a revision 
letter, i.e.. Revision A. Each and every page that a revision affects will have 
che revision letter as part of the footing, after the manual name, i.e. , SYSREF 
(Eev A) . When conmunicating with your distributor regarding documentation be sure 
to tell him the version and revision number of your. manual. 



Befereiaced or Related Sfcaterial 

The following manuals provide information describing other programs available to 
wlie OASIS user: 

OASIS BASIC Language Reference Hsomal 
OASIS SCRIFT ProccMSsor Refercsnce Hannal 
OASIS Text Editor Reference M^mial 
04SIS ESEC Language Reference Hanoal 
OASIS MACRO Asseahler language Reference Manual 
OASIS BIQBirS Reference MamaaX 
OASIS Biagncmtlc & Con^imrslon Utility Program Reference MsasamaX 
OASIS Coawnnlcatlons Refercmce Mamsal 
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CHAPTER 1 
IHTRODBCTIOH TO OASIS 

This version of OASIS is single-user or multi-user, programming and operating 
system designed for Z80 based micro computers. It permits a wide range of 
peripherals (printers, terminals, disk drives, etc.) and up to 784K of memory. 

l.l OASIS Design Philosophy 

The OASIS Operating System was designed with four major ideas in mind: 1) OASIS was 
to be implemented on micro-computers but have features traditionally found on mini 
and mainframe computers; 2) OASIS would be implemented on machines from several 

manufacturers; 3) the micro-computer market consists of mainly uninitiated computer 
users; 4) programers and systems designers are accustomed to having an operating 

system perform all of the tedius tasks required in program development and 
execution. 

The first idea was easily solved as the background of the designers of OASIS is 

almost exclusively in mini and mainframe machines and both in OS design and 
applications design and programming. Users of OASIS will find many programs, 
concepts and syntax familiar if they have used mainframe computers or 
minicomputers. 

The second idea was more difficult to implement because it implies machine 

Independence. Although OASIS is not totally machine independent there are only a 
few sections of OASIS that require information specific to a machine. OASIS is 
designed very modularly, allowing for small changes to be made for implementation 

on another machine. All programs written by the user on one machine with OASIS can 
be executed on another with no changes to the user program. 

The third idea of uninitiated users is the most difficult. Partial solutions to 
this problem were implemented by making all functions of the operating system 
consistent; by providing a "help" feature in each command; by using English words 
for command names; and by providing a means for system's developers to create 
pre-stored command sequences for specific functions to be carried out by the end 
wser. 

•'Jhe fourth concept was fulfilled by making all of the various functions of the 
cowmands intrinsic functions of the operating system. Some operating systems 
require a language product to be used for file management, peripheral input and 
output, etc. In OASIS all of these functions and more are part of the operating 
*'ystem. Language products merely access the operating system to perform specific 
Junctions. This implies easy programming and program versatility. 

• 2 Coaa^oaents of OASIS 

'^ASlS is cou^osed of many programs but these programs can be divided into a few 
.aajor categories: 

Nucleus The SYSTEM. NUCLEUS is a large section of instructions consisting of 
general purpose subroutines that provide the "intelligence" and 
integration of the system as a whole. It is the SYSTEM. NUCLEUS that 
is "booted" into memory when the system is first turned on. ("Boot" 
is a term referring to the process of "picking yourself up by your 

bootlaces". In cotcputers it Indicates that there are a few 
instructions that provide the means of accessing more instructions, 
that in turn provide the means for more, etc) 
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With the multi-user version of the OASIS operating system it is the 
NUCLEUS that controls the scheduling, memory management , and system 
resource sharing of the multiple users. 

Associated with the NUCLEUS (but physically separate) are device 
driver programs. These programs contain instructions designed to 
handle one specific peripheral device. The device driver programs 
are responsible for the actual acceptance and transmittal (input and 
output) of data to a device, error detection and error handling, and 
the initialization of the device* 

CSX The Command String Interpreter is the hub of OASIS communications; it 
provides access to system and user programs, and performs input and 
output functions. The combination of the nucleus, device drivers and 
the CSI is the essence of the OASIS operating system. Through them 
all computations, input and output are performed. 

Programs The various programs of the OASIS system provide the "sophisticated" 
means of processing information. It is sophisticated in the 
technical sense in that the various programs provide the intelligence 
to process information and data instead of just characters or 
"bytes". These programs consist of the system commands described in 
subsequent chapters of this manual and the language processors such 
as the MACRO assembler, Basic, EXEC, etc 

1-3 Prograa Developiaent Features 

Computer systems are often used extensively for program development. The* 
programmer makes use of the programming "tools" available on his system to develop 
programs which will perform functions specific to his needs. The number and type 
of "tools" available on any given system depend on a good many factors - the size 
of the system, its application and its cost, to name a few. The OASIS system, 
however, provides several basic program development aids not commonly found on 
micro~computers: system editor, macro assembler, linkage editor, on-line debugger, 
and high level languages: BASIC and EXEC. 

The editor is used to create and modify textual material. Text may be the lines of 
code which make up a source program written in some programming language, or it may 
be data; text may be reports, or memos, or in fact may consist of the text in this 
publication. (This manual and the other OASIS manuals were developed and printed 
using the editor and SCRIPT, an optional OASIS program.) Iti this respect using an 
editor is analogous to using a typewriter— the user sits at a keyboard and types 
text- But the advantages of an editor far exceed those of a typewriter because 
once text has been created, it can be modified, relocated, replaced, merged, or 
deleted — all by means of simple editing conmiands. When you are satisfied with the 
text you can save it in a disk file where it is available for later reference and 
use. 

When the editor is used for the purpose of writing a source program, development 
does not stop with the creation of this program. Since the computer cannot 
understand any language but machine language (a sequence of discrete codes), an 
Intermediary program is necessary which will convert source code into th^^ 
instructions the conq)uter can execute. This is the function of an assembler 
compiler, or interpreter. 

An assembler accepts alphanumeric representations of instructions, interprets the 
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codej and produces as output the appropriate object code. You can direct the 
assembler to generate a listing of both the source code and binary output, as well 
as more specific listings which are helpful during the program debugging process. 
The assembler is capable of detecting certain common coding errors and of issuing 
appropriate warnings. 

In addition to the normal features of an assembler, the OASIS MACRO Assembler 
provides a wide range of directives, system calls (subroutines in the operating 
system accessible to user programs), and macro capability. 

Source programs may be complete and functional by themselves; however, some 

programs are written in such a way that they must be used in conjunction with other 
programs in order to form a complete and logical flow of instructions. For this 

reason the object code produced by an assembler must be relocatable — that is, 

assignment of memory locations must be deferred until the code is combined with all 

other necessary object modules. It is the purpose of the linkage editor to perform 
this relocation. 

Very rarely is a program created which does not contain at least one unintentional 
error (bug). Often it is not until execution that the user discovers that a 
program is not working properly. Programming errors may be extremely difficult to 
find, and for this reason a debugging tool is usually available to aid the 
programmer in determining the cause of error. 

The OASIS debugging program allows the user to interactively control the execution 
of the program. With it, you can examine the contents of individual locations, set 
designated stopping points during execution (break points), change the contents of 
locations, continue execution, dis-assemble portions of the program, and add new 

instructions using mnemonics instead of machine code. 

A high level language, such as the OASIS BASIC interpreter/compiler, provides an 
alternate means of writing a source program other than assembly language mnemonics. 
High level languages are easy to learn — a single command may cause the conqputer to 
perform thousands of machine language instructions. In a high level language you 
►To not need to know about the mechanics of the computer. In addition, the OASIS 
3ASIC compiler offers a special immediate or command mode which allows you to solve 
jquations and formulas, or to interactively debug the program, similar to the 
ueougger for assembly language programs. 
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CHAPTER 2 

SYSTEM comsMick'nm 

The Command String Interpreter is the hub of OASIS system communications — it 
provides access to system and user programs, and contains the Executive Procedure 
Processor. The various system programs (utilities) accessible through the CSI are 
discussed in subsequent chapters of this manual. Major utilities, such as EDIT, 
EXEC, MACRO, etc., are described in separate manuals. 

2-1 Syst^ Start Procedure 

To load the OASIS operating system and start the CSI the following procedure must 
be followed. 

1. Turn the power on. If the power is already on then use the reset 
button, if available. 

2. Load an OASIS system disk in drive 1 and start the drive. 

3. After a short time the following message will be displayed on the 
console: ' 

Single-user OASIS version v.r ~ nnK 

or ' ■ 

Multi-user OASIS version v-r - nnK 

The v.r will be replaced by the current version and release number. 
The nn will be replaced by the amount of memory on your particular 
machine. If the message is not displayed after a reasonable period 
of time (5-10 seconds), unload the disk and reload it, making sure it 
is being loaded in the proper direction, etc 

4. The system will then display: 
Time (HH:MM:SS) 

At this point enter the correct time of day, pref errably in 24 hour 

format. It is not necessary to enter the seconds or any leading 
zeros. 

You may enter a carriage return only instead of the current time. 
When this is done the system will use the time of the last system 
start-up . 

Note: not all systems on which OASIS is implemented support this time 
of day feature. If your system does not support this feature this 
question will not be asked. 

5. The system will then display: 

Date (MM/DD/YY) 

Enter the correct date. It is not necessary to enter leading zeros. 
The date entered must be a valid date, and must be greater than 
01/01/77. You may enter the date using the month name such as: 
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Date (MM/DD/YY) 15 April 1978 

or in some other reasonable format . 

You may enter a carriage return only instead of the current date. 
When this is done the system will use the same date as that used at 
the last system start-up. It is permissable to omit the year number. 
When this is done OASIS will use the year number of the last start 
up. 

6. After a valid time and date have been entered the system displays the 

current time and date along with month name and day of week. Then 
the system locates the NUCLEUS, CSI, EXECSAVE, and ERRMSG files on 
the system disk, loads the NUCLEUS and CSI, finds and loads all of 
the ATTACHed and SYSGENed device drivers, and passes control to the 
CSI. If any of these files cannot be found on the system disk an 
error message is displayed. 

The location of these modules by the "boot" process saves 
considerable time during processing because no searches need be made. 
The tradeoff to this advantage is that the system disk may not be 
changed without re-locating these files. 

When the system is brought up in the manner described above the system attempts to 
automatically log onto the IPL account. In this automatic logon procedure a search 
is made of the file SYSTEM. ACCOUNT for the account IPL. When this account is found 

in the file the system logs onto the account. As discussed in the chapter on User 
Accounting, when an account is logged onto, a search is made of all attached disks 
for a file named: IPL. EXEC accessible by the account IPL (public or private 

access). This is the file name of the EXEC language program to be executed upon 
system logon. When the file is found control of the system is transferred to it. 

When the file cannot be found the CSI retains control and the prompt character is 

displayed. 

If no logon start up program is desired you should create an empty file named 
<account name>.EXEC on the system disk. This will speed up logon start time 
because an exhaustive search is not made. 

For details on using the EXEC language refer to the EXEC Language Reference Manual . 

When the search is made of the SYSTEM. ACCOUNT file and no IPL account is found, the 
system will automatically execute the LOGON command. This command will ask you to 
enter the name of the account that you wish to log onto. For complete details of 
this command refer to the chapter on the LOGON Command. 

To simulate an operating environment without user accounting use the KILL option of 
the ACCOUNT command. This will delete the SYSTEM. ACCOUNT file. When no 
SYSTEM .ACCOUNT file is found the system reverts to a non-accounting environment. 

OASIS is distributed with no SYSTEM. ACCOUNT file defined. 

An example system start up dialogue, single user system, without a SYSTEM. ACCOUNT 
file defined: 



SYSREF - 5 



SYSTSS* HlflPESSiCS MAHOAL 

Single-user OASIS version 5.4 -ASK 

Time (HH;MM:SS) 1159 

Date (MM/DD/YY) 101079 

11:59:02 Wednesday, October 10, 1979 

>■'•■■ 

2.2 Tyjnam±c Input aiui Output 

As mentioned earlier, the NUCLEUS contains the instructions to handle peripheral 
input and output devices. These groups of instructions are called device drivers. 
In this manual these drivers are referred to as physical device drivers. Physical 
device drivers are programmed to meet the specific requirements of a specific 
device. An example of a physical device driver is the program containing the 
instructions necessary to handle a serial input/output port (SIO). The driver for 
the SIO has to have instructions capable of performing input or output on a bit by 
bit basis at a specified rate (baud). 

To make programming and operation of the system more versatile the OASIS operating 
system communicates with physical device drivers by means of a logical device name. 
The logical device name is nothing more than a linkage that points to a specific 
device driver. By using logical device names instead of the physical device 
numbers (physical device drivers are accessed by the number of the driver - refer 
to the appendix) it is very easy to change the input or output device of a program. 
All that is necessary is to change the number of the device driver that the logical 
name is pointing to. 

Only physical device drivers are capable of communicating with the "real" world 
outside of the con?)uter. The connection between the logical device driver and the 
physical driver is made by using the ATTACH program. 

By making the connection between logical and physical device drivers dynamic, or 
changeable, you gain a great deal in versatility. Programs are created with 
specifications such as printing to the printer or console. With no changes 
required in the program the output can be changed from a parallel interface line 
printer to a serial interface line printer, or from a serial interface line printer 
to a video display monitor, etc 

2*3 C«mf Igurisig Your System 

The ability to dynamically associate physical and logical device drivers would be a 
nuiisance if it had to be done every time the system was turned on. Also it would 
be inconvenient if you had to set the status of all the internal switches in OASIS 
every time (see the SET command). 

To avoid this inconvenience OASIS provides the SYSGEN program. With it you can 
"permanently" set the attached devices and switches. When the SYSGEN program is 
executed the current linkages of attached devices are saved in the disk image of 
the system nucleus. The next time the system is turned on the attachments and sets 
will already be in effect. (See the ATTACH, SET, and SYSGEN commands.) 
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CHAPTER 3 

USER ACCOUITTIHG 

The OASIS Operating System supports user accounting and restricted file access 
between user accounts. User accounting means more than the mere record keeping of 
the time that each person uses the system. In OASIS it also means that a user may 

only access the public (common) files and programs, his own files and programs 
(private files), and those select files and programs of other users who have given 

him explicit permission to access them (shared files). Similarly a user's files 
and programs may not be accessed by any other user without his explicit permission. 
Additional accounting information is generated for system restarts. 

3.1 File Ownership 

User accounting utilizes the concept of file ownership. In a user accounting 
system each file is "owned" by one account and only one account. Files owned by a 
user account are referred to as "private" files. Private files may only be deleted 
or changed by the owner of the file. Under certain conditions a user account may 

have access to another user's private files. When this is true those files owned 
by the other account are referred to as "shared" files to the non-owner of the 
file. File sharing is strictly controlled by the operating system. A shared file 
may be changed by the noa~owner but may not be deleted. 

A special type of shared file is the "public" file. A public file is a file owned 
by the system account and all users have access to them without the necessity of 
specifying them as shared files. Usually the system programs are kept in the 
system account so that all users may utilize them. 

The above ideas may best be clarified with an example. Suppose that a system has 
the following accounts and files: 

Account File 



System BASIC. COMMAND 
RUN. COMMAND 
EDIT. COMMAND 
ERASE. COMMAND 
RENAME. COMMAND 
FILELI ST. COMMAND 

RALPH LEDGER.MASTER 
LEDGER. DETAIL 

LEDGER .HI STORY 
LEDGER. BASIC 

Ul'DA PAYROLL .MASTER 
PAYROLL .DETAIL 
PAYROLL. HISTORY 
PAYROLL. BASIC 

Jf no files are designated as being shared files then RALPH can use the programs: 
BASIC, RUN, EDIT, ERASE, RENAME, and FILELIST (public files); he may execute the 
BASIC program LEDGER, and he may change or delete the data files: LEDGER.MASTER, 
LEDGER .DETAIL, and LEDGER. HI STORY (private files). When RALPH is logged on the 
t:ystem he would not even know about LINDA's files nor could he access them in any 
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LINDA can use the programs : BASIC, RUN, EDIT, ERASE, RENAME, and FILELIST too. 
However she may only execute the BASIC program PAYROLL and she may only change or 
delete the data files: PAYROLL .MASTER, PAYROL. DETAIL, and PAYROLL. HI STORY. 
Similarly when LINDA is logged on the system she would not know about RALPH'S files 
nor could she access them in any way. 

When the system account is logged onto (usually only done for system maintenance 
purposes) neither RALPH's files nor LINDA's files could be accessed in any way. In 
this case there are no public files and the system account cannot have shared 
files . 

Assuming that RALPH's program and files perform General Ledger accounting functions 
and that LINDA's program and files perform Payroll processing it would probably be 
best if RALPH specified that his files: LEDGER.MASTER and LEDGER. DETAIL could be 
shared by LINDA. If this were done (using the SHARE command) then LINDA could 
create General Ledger entries reflecting her Payroll processing in RALPH's files. 
(LINDA could not delete these files^ — only the owner of a file can delete it.) 

Say that Ralph gets fired and Linda is promoted to do both Payroll processing and 
General Ledger accounting. Before removing the account RALPH from the system 
(using the ACCOUNT command) his files should be transferred to the account LINDA. 
When this is done (using the OWNERCHG command) the LINDA account would own her 
original four files plus the four LEDGER files previously owned by the RALPH 
account . 

IMPORTANT! Extreme care should be taken when deleting an account name from the 
system. Before deleting the account all shared access to any of the account's 
files should be removed (using SHARE command) and then any of the account's files 
to be kept should be transferred to another account. Any files that are not to hd 
used again should be deleted. 

If the above procedure is not done before an account name is deleted YOU MAY NOT 
EVER BE ABLE TO ACCESS THOSE FILES AGAIN. Re~adding a deleted account does not 
necessarily make the deleted account's files accessible. 

3«2 Adding Accotmts 

As mentioned in the above example there are special programs that perform the user 

accounting features. When an OASIS system is first received it has no accounts- 
To start using the accounting feature you will have to add accounts with the 
ACCOUNT command. The ACCOUNT command allows new account names to be added and 
allows maintenance (changing and deleting) of existing accounts. 

Before any new accounts are added to the system the user should determine whether 
or not the accounting feature is to be kept as a part of the system (it can be 
disabled but not easily re-enabled). 

3-3 Privelege Lefvels 

When setting up new accounts (or changing existing ones) the question of privilege 
level is asked. The privilege level of an account determines which commands may be 
executed by the account. Each system command has its own privilege value 
associated with it. These privilege values may be changed by the user with the 
CHANGE command to conform to his own requirements. 

In the previous example assume that RALPH has a privilege level of and that LINDA 
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has a privilege level of 1 and that the privilege values of the commands are 
unchanged from the distribution values (see Appendix "Privilege Levels"). In this 
case RALPH could only execute the commands RUN and FILELIST. His privilege level 
is not high enough to execute the other commands. This essentially restricts him 
from changing or adding any files in his account except under the control of his 
BASIC program (he has to use RUN to execute that program and RUN does not allow the 
operator to make changes in the program.) 

LINDA, on the other hand, can execute all of the commands that are in the system 
account in the example. Therefore she, unlike the RALPH account, can erase files, 
rename files, edit files and use BASIC to debug and/or make changes in her program. 
She still would not be allowed to erase or rename any of RALPH's files even if she 
had shared access to them (also the EDIT command would not allow her to change any 
of RALPH'S files because it erases and renames a file in the process of updating 
it). 

It is best to leave the system account (or a synonym of it) at the highest 
privilege level available. This would allow anybody that had permission to log 
onto the system account to execute all of the commands in the system. 

3.4 Accoent SynonyBis 

The word synonym was used in the last section. A synonym of an account is an 
account that is identical to the account it is a synonym to but has a different 
name, and possibly a different password and/or privilege level. In the example 
-?here RALPH has a privilege level of the question of file maintenance arises: How 
can RALPH'S program be changed? One way would be to set up another account that 
has shared access with RALPH's program file, copy the file from RALPH's account 
into the new account (giving it a unique name), performing the required 
maintenance, establishing it as a shared file with the RALPH account. Now the 
RALPH account can use the new version of the program. Obviously this is rather 
tedious. 

A better way would be to establish a new account that is a synonym to the RALPH 
account that also has a privilege level of at least 1. When this new account is 
logged onto (say it was named MICHELLE) the account will have the the same file 
access as the RALPH account but the privilege level will be 1. This privilege 
level allows the execution of the EDIT command. Any changes made while MICHELLE is 
logged on will be made to the RALPH files. 

Synonyms have another important use. Even if the password and privilege level are 

:he same between an account and its synonym, the account name will be different. 

This means that any accounting history generated by the two accounts will.be 
Jls t inguishable . 

, •'*.5 Acccsimt FaBswords ' 



Another question asked when an account is added or changed is the account password. 
All accounts have a potential password associated with them. When a password is 
defined for an account it must be used each time an operator attempts to log onto 
the account. If the operator does not know the password he or she will not be able 
CO log onto that account. This implies that the operator will not be able to 
access any of the files or programs that are owned by that account and not shared 
with other accounts. 

When the owner of an account (or anyone else who knows the password) logs onto an 
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account and enters the password the password is not displayed as it is entered. 
This prevents others who don't already know the password from inadvertantly finding 
out. The password provides a reasonable level of file and account security. 

3-6 Accotoiitiiig History 

As stated at the beginning of this chapter, user accounting implies the collection 
of user account accounting information. In the OASIS system a history record is 
generated every time a user logs onto or off of an account. This history record 
contains the information answering the questions: Who logged onto the system? When 
did they log onto the system? and How long were they logged onto the system? 
Additional information is recorded showing when the system was booted, when a disk 
was backed up and to where. 

This account history information is kept in the special file named SYSTEM. HISTORY. 
This file is special in the sense that no account owns it. This history file, 
similar to the account name file SYSTEM. ACCOUNT, cannot be accessed by any user. 
The SYSTEM. HISTORY file (and later the ACCOUNT. HISTORY file) contains records 
accounting for each system start up, each user LOGON and LOGOFF. 

In order to access the accounting information kept in the history file you must use 
the option CLEAR in the ACCOUNT command. This option will transfer the data in the 
SYSTEM. HI STORY file to the system account's file AC COUNT. HI STORY. Once this has 
been done the information is accessible to all users as the file is public. This 
procedure should be done periodically anyway as the SYSTEM. HI STORY file can grow to 
use up all the space on your system disk. 

Fhen the SYSTEM. HISTORY file does grow to use all of the space available on the) 
system disk the program that was trying to add a record to the history file will 
inform you that it has used all the space available and that you should use the 
ACCOUNT command to clear the file. When this is done there still won't be any 
space available but you will have access to the ACCOUNT. HI STORY file and can either 
erase it or copy it to another disk and erase the file on the system disk. If you 
do not make space available for the SYSTEM. HISTORY file no more accounting records 
will be added but you will be allowed to log on and off accounts. 

This accounting history feature is optional and may be enabled or disabled by the 
user (see the SET command). OASIS, as distributed, has this history feature 
disabled. 
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MULTI-USER OASIS 

OASIS, versions 5.4 and above, is available in single and multi-user versions. A 
TTiuiti-user operating system is a system that allows more than one user (console) to 
,o controlling the computer at one time. Each user in a multi-user system operates 
as if be had the complete attention of the computer to perform his task. 

In multi-user OASIS each user is given a portion of memory to have exclusively. 
Additionally, each user has access to the single copy of the operating system in 
memory 3.nd any re-entrant programs that may be available. A re-entrant program is 
a program that can be utilized by more than one user at a time, without having 
multiple copies of the program in memory. OASIS BASIC is a program that is 
available as a re-entrant command. 

Although a computer can only perform one single operation at a time it operates a 
such a high speed that it can service several users at one time by switching 
between users, giving a portion of time (a time slice) to each user. When the time 
slice is used up the system suspends the operation of that user and allows another 
user to have a time slice. When that user has exhausted his time slice the next 
user is selected and so on. Because a computer operates at very high speeds this 
sharing of time is generally transparent to the user. • 

.>x user may lose his time slice if, for any reason, he is waiting for an input or 
:-utput process to complete. 

Certain problems may arise when using a multi-user operating system. Specifically, 
the situation may arise that two users try to update a disk file. Both users may 
have read in the same copy of a record, made changes to the record without the 

knowledge of the other user, and then written the changed record back. The record 
aange written back last will be the change that is actually made to the file. 

:'his coaid be disastrous if the record was a balance record for example. 

r.n multi-user OASIS this situation can be easily prevented in one of two ways: the 
■^irst user may put a lock on the entire file, thus preventing the second user from 
iiaKian any changes to the file; or both users miay put a lock on the record — the 
iser wlio puts the lock on the record first will prevent the second user from 
re.acilng the record until the lock is released, thus insuring that the second change 
JO Cne record will be made to the correct copy of the record- 

lulti-user OASIS requires that the user accounting feature be used and that each 
isai be logged onto a different account. However, the accounts that the users are 
„^5ged bn to may be synonyms to each other. 

"^iti-usex OASIS also provides other convenient features; transmitting messages 

VJi user to user (MSG), forcing a user to execute a command (FORCE), peeking at 

ricjvher user's console output through your own console (PEEK), scheduling jobs for 

Mture -xecuticn (SCHEDULE), display status of other users (SHOW MEMORY) . Of 

^aise ail of the single user programs and features are available too, including: 

iser accounting; private, public, and shared file ownership; optional printer 

;'.;pooler; complete program development package — ^MACRO Assembler, debugger, linkage 

editor, BASIC compiler and interpreter; system diagnostic programs — disk verify, 

iiiemcry test; etc 
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When multi-user OASIS is first booted into memory it is set up in single-user j 

mode— only one user is defined. At this tiaie the system's manager should define I 
and initialize the users to be utilized. This is accomplished with the SET MEMORY 

command and the START command. As each user is started the respective consoles i 

will request that the operators logon to an account. That is all that is necessary j 

to use multi-user OASIS. This process of invoking multi*-user mode may be j 

automatically performed if the system's manager defines an account named IPL with j 

an I PL. EXEC program that performs the necessary commands to set tip the system. ( 

. I 

After some usage of the system the system's manager may decide that the time slice | 

value (the amount of time allocated to each user partition) is not proper for the j 

applications being used. This is changeable with the SET SLICE command. | 

A typical multi-user start up would look like: | 

■ ■ ■ I 

Multi-user OASIS version 5.4 - 64K j 

I 

Time (HH:MM;SS) 830 | 

I. 

Date (MM/DD/YY) 1030 i 

■ ■ ■ [ 

08:30:00 Tuesday, October 30, 1979 ! 

Logon Please: IPL { 

f 

>ATTACH A DISK2 (PUBLIC | 

I 

>L0AD BASIC 

>SET MEMORY 2 10240 f 

■ I 

>START 2 (SI02 B19200 C4 FF6 j 

■f 

>SH0W MEMORY | 

-• ■ I 

Port MEMLO MEMMX MEMHI SP- PC- Size Routine Us ername | 

OOOOH 4CFFH 19712 NUCLEUS 1 

4D00H A886H 23431 BASIC | 

1* D087H FDFFH FB21H FAF3H D087H 11641 SHOW IPL | 

2 A887H D086H CDA9H CD87H CDCFH 10240 LOGON | 

f 

>LOGOFF I 

■ I 

Logon Please: f 

The above start up procedure will result in disk S and disk A being public (all j 

users may access), two users, and re-entrant BASIC available to both users. As can I 

be seen, this start up procedure is kept in the IPL.EXEC file in the account IPL. | 

All entries after the date and before the LOGOFF were miade by the system or the 
EXEC, nothing special had to be done by the operator. 

Your start up procedure might be different in the number of users, public disks and 
whether or not the re-entrant BASIC is loaded. 
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I 4*2 Single-user Mode 

When only one user is defined and active in the system the system is said to be in 
single-user mode. This mode is important because some tasks may only be performed 
in single-user mode, such as full disk backups, loading and unloading re-entrant 
programs and detaching public disk volumes. 

In the above start up procedure, note that the public disk and the re-entrant BASIC 
are both attached or loaded before establishing a second user to the system. This 
was done because these operations are required to be performed in single-user mode. 
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The OASIS Operating System is essentially a file management system. The operating 
system consists of programs that manipulate or maintain files on the random access, 
mass storage device (disk drives). Each disk may contain a mixture of data anc^ 
program files. 

A file is a logical group of records, records being the individual elements. An 
example is a customer name and address file. The file is a group of customers; the 
records are the individual customer names and addresses. 

The operating system has the ability to handle up to eight disk drives, if 
available. However, each disk is maintained independently of others. This means 
that a file may not start on one disk and continue on another. A file must be 
completely contained on one disk. 

Each OASIS disk must be initialized before any files may be written to it. The 
initialization process is accomplished by using the program INITDISK with the 
FORMAT option. This program need only be executed once for a disk. However, there 
is no restriction on re-initializing a disk. The initialization process is 
necessary because a new disk, as received from the manufacturer, has no or wrong 
information written on it. The initialization process writes information on the 
disk necessary for OASIS to add files to the disk. The information written is a 
blank directory, a disk label, an allocation map indicating that the entire disk is 
available for new files, and data blocks. Data blocks are IK blocks or sections of 
storage. IK is a symbol representing 1024 bytes or characters. 

The directory is an index which contains the contents of the disk and pointers to 
the data areas which constitute the files on the disk. 

After a disk has been initialized, the other programs in the operating system can 
use it for adding files, changing files, erasing files, etc 

5.1 Directory Ha»iiig 

The files on a disk are accessed by specifying the file name, file type and the 
disk. The disk is specified by the disk label (established in the INITDISK 
program) or a one character directory label (established by the ATTACH program). 

This directory label is really just an indication of which disk drive the disk is 
in and only has meaning while the disk is In that drive. 

The directory label is one of the following characters: S,A,B,C,D,E,F,G. The S 
label is reserved to indicate the system disk and may not be attached to any other 
disk. (A system disk is the disk that contains the operating system programs and 
is the disk that the system was "booted" from at system start up time.) 

A directory label may be attached to only one drive at a time, and a drive may have 
only one label attached to it. 

5*2 Data and File Formats 

The OASIS system makes use of five file formats: ASCII sequential, indexed, direct, 
absolute, and relocatable. 
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5.2.1 ASCII Sequential Files 

Files in ASCII format conform to the American National Standard Code for Informaton 
Interchange, in which each character is represented by an 8-bit code. Files in 
ASCII format include program source files created by the Editor, listing files from 
the MACRO assembler, object files from the MACRO assembler, and data files from 
user programs. 

An ASCII file, when accessed by some of the system programs, such as the Editor or 
BASIC, is read into memory as a whole. Other system programs and user programs 
usually access this type of a file one record at a time. The reason it is called 
an ASCII sequential file is that a record cannot be accessed without accessing all 
records prior to it in a sequential manner. 

This type of a file is the only format that supports variable length records. The 
length of a record is determined by the contents of that record, not by the access 
method. 

A sequential file cannot be updated in place. The only form of update that may be 
performed on a sequential file is appending records to the end of the file. Of 
course the file can be erased as a whole. 

The size of a sequential file is determined dynamically. When the file is first 
created it is allocated the minimum size: IK bytes. When a record is added to the 
file that will not fit in the current allocation one more block of storage is 
allocated to the file and the record is written to the new area* This is the only 
file format that does not require contiguous data space. Each block of data may be 
anywhere on the disk with each block of data having a pointer to the block that 
logically follows. 

5.2.2 Blrect File Fooaat 

A direct file contains binary data with fixed length records and fixed number of 
records. This format is used by user programs, generally for master type data* 

A direct file is accessed randomly by relative record number. This means that any 
record may be accessed independently of all other records in the file. To access a 
specific record the only information required is its record number, relative to the 
start of the file. 

The size and record length of a direct file must be known when the file is first 
created. A direct file is created by using the CREATE program. 

5«2.3 Ini^xed File Fox%^^ 

OASIS supports a single key, hashed, sequential access file format called indexed. 
Similar to the direct file, an indexed file contains fixed length records, fixed 
allocation file size. 

An indexed file is accessed randomly or sequentially. The only information 
necessary to access a specific record is the key that it was written with. 
Normally this key is logically associated with the record such as a customer name 
for a customer record, part name for an inventory record, etc The key may be up 
to 128 characters in length but the maximum length must be known when the file is 
created with the CREATE program. 
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The combination of keyed access and sequential access allows you to simulate 
"approximate or generic key match" access. Approximate match means that the key 
field of the record accessed may be equal td or greater than the specified key. 
Using an index, it is often desirable to access the record that contains the key 
value requested, or the record with the next highest key value if the requested key 
value doesn't exist in the file. This allows a user program to retrieve records 
without knowing an exact key and without repeated access operations when the system 
does not have the record specified by the key. 

An indexed file can be read sequentially in key sequence. This makes this file 
format very useful for many applications in which the information is updated 
randomly but is required to be listed in sequence. 

An indexed file is always maintained by the system in sequence- There is no 
"overflow" area to be sorted periodically. 

5»2o4 Absolute File Format 

Absolute files are generated by the system linking loader and are restricted to 
machine code programs. These files contain programs in a "memory image" format 
which is a "picture" of what memory will look like when a program is loaded. The 
file itself requires the same amount of disk storage as the corresponding number of 
256-character memory blocks. 

5»2«5 Relocatable File Forsat 

Relocatable and self-relocatable files are also generated by the system linking 
loader and are restricted to machine code programs. A relocatable file is origined 
at address zero. When the program is run (by entering the program name at the CSX 
level), the file is relocated as it is loaded into memory. (An absolute file 
requires no such relocation.) A self~relocating program is also origined at zero. 
The programmer has the responsibility of using a special system subroutine before 
each reference to an absolute address. This system subroutine (referred to as a 
system call) adjusts the address reference. 

5«3 File mid Bisk Protection 

In many applications for computers it is desirable that there be some means of 

preventing the inadvertent alteration of stored information- The user may wish to 
prevent programming errors from changing master files or he may wish to prevent 
operator errors. The OASIS file management system provides this means - 

Any specific data or program file may be protected from erasure, alterations^ or 
both. This protection is specified to the system by using the RENAME program. By 
using this program you can delete protect, write protect or read protect a file or 
group of files. 

^^en a file has delete protection the system will not allow any program to erase 
the file. 

When a file has write protection the system will not allow any program to make 
changes to existing records in the file or to add new records to the file. A file 
that is write protected is not necessarily delete protected. 

When a file has read protection the system will not allow any program to access the 
file (writing to a file requires that part of the file first be read), with the 
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exception of the RUN command. This protection is intended to be used to protect a 
BASIC interpretive program file. 

In addition to this specific protection the system provides a means of protecting 
an entire disk of information from being altered in any way. To write protect an 
entire disk the INITDISK program is used. 

When a disk is write protected no file on the disk may be deleted or changed by any 
program. 

5.4 Program Protection 

System programs may be protected from unauthorized execution by means of a 
privileged access method. All of the system programs have a privilege value 
associated with them. The system has a privilege level associated with it. Any 
attempt to execute a program whose privilege value is greater than the current 
system privilege level will be ignored. The operating system is distributed with 
the highest privilege level available (5), thus allowing access to all of the 
distributed programs. The privilege level of the system may be lowered, thus 
restricting access to programs with a privilege value higher than the value that is 
set. , 

The privilege values for the system and the system programs may be changed by using 
the CHANGE command. This allows you to set your own levels of access. The 
privilege level of the system is a SYSGENable function, allowing you to 
"permanently" set the level of access. The appendix on Privilege Levels defines 
the methods of changing the privilege levels and values and defines the values of 
the programs, as distributed. 

5.5 Multi-Huser File and Record Locking 

A feature available with multi-user OASIS is entire file locking or individual 
record locking. When a file or record is locked by one user other users are denied 
access to that file or record until the user that has locked the file or record 
unlocks it. 

This feature is very necessary for the prevention of bad data. Without file or 
record locking user one would be able to read a record, user two could also read 
that same record, change it and write it back without user one knowing that the 
record he has is no longer current. 

File and record locking is easy for the user to specify — see the OASIS BASIC 
Language Reference Manual and the OASIS MACRO Assembler Language Reference Manual * 

Caution: Deadlocking may occur if care is not taken when programming an application 

in a multi-user environment. A deadlock is when a user's processing is suspended 

for an excessive time due to the careless locking of a record or file by another 
user partition. 
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OASIS system conventions such as file naming procedures, prompting characters, etc. 
are described in this chapter. You should be familiar with these conventions 

before running the system. 
6.1 Directory Seardbi Criteria 

When OASIS is capable of using two or more file directories, a problem of search 
order arises. If, in a specific program, you specify which directory to examine 
for the file, there is no doubt as to where and how to search directories- In some 
cases you do not or cannot designate a directory. In this situation there must be 
a set search sequence for scanning directories to find a specified data file or 

available disk space. 
Standard Search Order 

To find a data file or user program (not a user written command), user disks are 
searched in the system-defined alphabetical order; A, B, C, D, E, F, G, S. 

To find a command or EXEC program the system disk is searched first and then the 
user disks: A, B, C, D, E, F, G. 

To find space for creating a new data file the system disk is searched first and 
then any user disks . 

■6-2 FriOii^tiiig Characters 

The OilSIS operating system uses different prompting characters for each of the 

programs that accept input from the keyboard. This provides an easy means of 
determining which program is asking for input. The following table summarizes th€i 
characters displayed by each program to indicate to the user that the system is 
awaiting user response. 

> The Command String Interpreter is waiting for a command. 

* TEXTEDIT or EDIT is waiting for a command. 

— BASIC Is waiting for a coimnand. 

7 A BASIC program is waiting for input. This prompt can be changed by the 

user program, 
s An EXEC program Is waiting for input. 
» The system DEBUG program is waiting for a command. 
^ A system program has displayed a full screen of data and is awaiting a 

response to indicate that it may proceed to the next screen. 
\ The PATCH program is waiting for a command. 
J The COl^YFILE program is waiting for input to the translation list. 

The COJPYFILE program is waiting for input (only when from file is CONSOLE). 
4^ The LINK program is waitings for input. 

y{^3 W±t^Mm/A$i^ Cowr&attomm 

ic^ach file created by the system or by a user program is referenced by a file 
riescription. The description consists of three elements in the following format; 

filename.filetypfi:filedisk 

filename Is a one to eight character alphameric name assigned (in most cases) by 

- is - msmm 
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the user. The first character of a file name raust be a letter, 
may only contain letters, digits, or a dollar sign. 



The name 



filetype Is a one to eight character alphameric name used as a descriptor or 
qualifier of the filename- Certain f iletypes have special meaning to 
OASIS and should be used accordingly. The first character of the file 
type must be a letter and only letters, digits, or dollar signs may be 
used for the other characters. Imbedded spaces are not allowed in file 
names or types. 

filedisk This may be either the directory label of the disk or the disk label of 
the disk on which the file resides. 



Most of the programs in OASIS allow the file disk specification to be 
omitted. In this situation the system will search the disks for the file, 
stopping on the first occurrence of the file name and type. 

The OASIS operating system has several reserved file descriptions: 



IPL.EXEC 

SYSTEM.NUCLEUS:S 
SYSTEM. CSI:S 
SYSTEM. EXECn:S 
SYSTEM.DEVNAMESrS 
SYSTEM.ACCOUNT:S 
SYSTEM.HISTORY:S 
SYSTEM. ERRMSG:S 
SYSTEM.EXECrS 
SYSTEM. SPOOLER: S 
SYSTEM. SPOOL $$n 
SYSTEM.DEVnn:S 
SYSTEM.CLASSnn:S 



~ system start-up procedure. 

- the "core" of the operating system. 

- the Command String Interpreter. 

- working storage for executive procedures - 

- physical device names and attributes. 

- user accounting name, passwords, and privilege levels 
~ user accounting history, etc. 

~ error numbers and messages . 

- EXEC language processor. 

- print spooler program. 

- spooled print files. 

- Device drivers. 

-Terminal class code translators. 



These file desciptions should not be used for any function other than as provided 
when the operating system is distributed. 

Additionally, there are several file types that have special or default uses by 
various OASIS commands: 



COMMAND 

OBJECT 

FORTRAN 

COBOL 

PASCAL 

BASIC 

BASICOBJ 

BASICCOM 

BASICUSR 

LOADFILE 

SCRIPT 

ASSEMBLE 

SYNONYM 

EXEC 

LINK 

COPY 



- Required by all commands that are executed by CSI. 

- Required by the LINK command for its input files. 
—Default file type for a FORTRAN language processor. 

- Default file type for a COBOL language processor. 

- Default file type for a PASCAL language processor. 

- Default file type for a ASCII, BASIC program. 

- Required file type for the BASIC interpreter. 

- Required file type for the BASIC runtime monitor (RUN). 

- Required file type for a BASIC assembly language 
subroutine. 

- Default file type for a re-entrant, loaded program. 

- Default file type for the SCRIPT processor. 

- Default file type for the MACRO assembler 
-Required file type for a command synonym table- 

- Required file type for the EXEC language processor. 
-Default file type for a LINK control file. 

- Default file type for the MACRO assembler, copy files. 
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MACRO ~ Required file type for the MACRO assembler, macro 

definition. 
MACLIB - Required for a library file of macro definitions. 

BACKUP - Required by EDIT /TEXTEDIT as a copy of the input file. 

These file types must be used when indicated and should only be used for the above 
purposes. 

The file description SYSTEM. WORK $$n is used by the system for work files. Avoid 
using this file type as your file may be erased by the system when it wishes to use 
a work file by the same name- 

The file name of HELP should be not be used for data files or high level language 
program names as this name is reserved to indicate that a "help" message is to be 
displayed about the program. 

6.4 Wildcard Specifications 

Some of the commands allow you to specify more than one file at a time. For 
instance, the FILELIST command allows you to specify a list of all files on one 
disk, or all files x-^ith a specific name or type. In addition to these general 
features the system allows you to specify all files starting with a specific 
character or string of characters, etc. 

The following definitions and examples illustrate the various ways that a file name 
or type may be specified. These features are only permissible when the command 
allows you to specify more than one file. This way of specifying a file 
description is referred to as "Wildcards". 

Definition 

* Indicates that any characters from this position through the end of the 
field are acceptable. 

T- Indicates that any character in this position is accejptable. 

((#} # Indicates that any alphabetic character in this pasitioii is acceptable. 
^ IndiGates that any numeric character in this position is acceptable. 

» Indicates that the source file description for this element is to be used 

for this character position through the end of the field. This wildcard 
is only available in the COPYFILE and RENAME programs. 

r:i:aiuples: . 

^^ BASIC S 

"^hls file description indicates that all files whose type is BASIC on the S disk 
.^nte to be included. 

GLUP« B??????# S 

This file description indicates that all files whose name starts with the 
characters GLUP, whose type starts with the character B, has a number in the eighth 
position and is on the S drive are to be included. 
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This file description indicates that all files should be included whose name is at 
least seven characters long, of which the first four characters are alphabetic, the 
next two may be any character, the seventh character is numeric and the eighth 
character may be anything, including a space. The type must be two alphameric 
characters only and the file may be on any disk. 

6*5 Nmaeric Faraiaeters 

Some of the commands discussed in this manual allow certain parameters or options 
to be numeric. The system allows these elements to be entered using either numeric 
base ten (decimal) or base sixteen (hexadecimal). Decimal numbers are entered 
using only the digits 0-9. Hexadecimal numbers are entered using the digits 0-9 
and characters A-F with the first character numeric and the number is terminated 
with an H. Examples of hexadecimal number entry are 14AFH and OFFFFH. 

6.6 HELP Function 

When you first start using the system you will be unfamiliar with the command 
syntax of the various commands in the system. As an aid to the beginning user (and 
for those commands that are infrequently used) most of the OASIS commands have a 
HELP function available to them. 

If, for whatever reason, you are unsure of the command syntax or options available 
enter the command name followed by a space and the word HELP. The command will 
display the following information: 

* General function of the command. 

* Syntax of the command. 

* Options and functions available with the conmiand. 
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HELP Example: 

>ATTACH HELP 

Function: To map a logical device to a 
physical device, or to un- 
attach a logical device, or 
list current attachments. 

Syntax: ATTACH log [phy [(options)]] 

Where: 

log - CONSOLE, PRINTERn, READER 

PUNCH,COMMn,TAPEn, drive 
phy - Are the names defined in 
SYSTEM.DEVNAMES:S 

Options: 

Lnnn - line width for con,prt 

Pnnn - page depth " " " 

Bnnn ~ baud rate for SIO 

LFnnn & FFnnn - delays for SIO 

PE & PO Parity Even or Odd for SIO 

ENAB Auto enable (CTS/RTS) for SIO 

PP maintain Page Parity for PRT 

Onnn size of Overflow margin for PRT 

ALF Auto Line Feed for PRT 

Hnnn Head load delay (msec) 

Rnnn Disk retry count 
STPnnn Track step time (msec) 
STSnnn Step settle time (msec) 

6«7 Forsis AllgjEHnent 

The OASIS operating system always assumes that the forms in a listing device are at 
top of form and that the printing mechanism is at the left hand side of the page« 

Whenever an OASIS program uses a listing device the program will always close the 
device with the forms at the top of form position and the printing mechanism at the 
left hand side. Any user written programs should also follow this convention for 
consistency. 

6«8 Prograa Eetam Ck>de 

The system return code (displayed when RDYMSG set on) is a numeric value that, in 
general, indicates whether the previous program was executed to completion and 
whether it was successful. This code is very useful when programs are executed 
from an EXEC program or during testing of a new program. • 

There are seven specific return codes used by OASIS system programs. User written 
commands should conform to these return codes for consistency. (The return code is 
set by loading register A with the value immediately before returning control to 
the operating system*) 
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Program Return Codes 
RC Meaning 

Normal job completion. 

4 Warning errors encountered. 

8 Syntax errors detected in command line. 

12 Severe error detected (file not found, etc) 

16 Potentially disastrous error detected (disk/system integrity 
may be suspect). 

253 Fatal, run-time error during RUN command. 

254 Program canceled by operator using System Cancel-key. 
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SYSTEM CONTROL KEYS 

OASIS has twelve control keys defined for special use in controlling the system. 
The functions of the keys are such that you may wish to use them while a program is 
in operation. These keys may only be entered from the device attached as the 
console keyboard. The first seven of these keys will clear the type-ahead buffer. 

7»1 System Restart-key 

This key will cause the operating system to quit the current program in execution 
and cause the system to "re-boot". This key takes action immediately upon entry. 
Caution should be exercised in the use of this key as any open disk files that are 
being updated will not be closed. Any open files may then be logically invalid. 
The message "OK to IPL?" is displayed following the entry of this key. You must 
respond with a Y to actually perform the restart. 

The System Restart-key is not available on multi-user OASIS as it could cause 
disastrous results. 

7.2 System Cancel-key 

This key will cause the operating system to quit the current program in execution 
and return control to the next higher level of program. Normally the next higher 
level is the operating system itself but in some cases a program may be executed 
from the Executive language. In this case the system will ask you "Cancel EXEC 
(Y/N)?". Answering with an N will cause the current program to be cancelled but 
control will return to the EXEC program. Answering with a Y will cause the EXEC 
program to be exited also. 

When this key is entered a "clean" abort is performed: open file buffers are 
written to the disk file and files are closed. 

Whenever this key is entered three of the toggle type keys will be reset: Printer 
Echo-key is set off; Console Echo-key is set on; Program Pause-key is set off. 

7»3 Printer Echo-key 

This key is a toggle type key, that is, entry of the key once causes the function 
to start, entry of the key again causes the function to stop. The function of this 
key is to cause all characters output to the console to be displayed on the primary 
listing device. When the system is first started the status of this key is "off". 

7.4 Console Echo-key 

This key is a toggle type key, similar to the Printer Echo-key. The function of 

this key is to cause all characters output to the console to be displayed or not 

displayed on the console. When the system is first started the status of this key 
is "on". 

7-5 Prograai Faase-key 

This key is a toggle type key, similar to the Printer Echo-key. The function of 
this key causes any program currently executing to "pause". Unless the program is 
accessing the disk, entry of this key will cause the program to stop whatever it is 
doing. When the Program Pause-key is entered again the program will continue from 
the point at which it was interrupted. 
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7.6 Program Cattcel-^ey 

The function of this key is program defined and roost programs ignore it. However a 
few of the OASIS commands do use it. For example, BASIC uses it to stop the 
execution of a program and return to its command mode; RUN uses it to to set a 
testable error (the application program can then do whatever it wants); DEBUG uses 
it to abort a command in progress and return to its command mode; SCRIPT uses it to 
allow you to abort the printout after the completion of the current page. 

7«7 Bebug Break-key 

Entry of this key causes a "break-point" immediately. It is only effective if the 
system debugger has been loaded. If the debugger is loaded the program counter 
will be displayed and control will be transferred to the DEBUG environment. 

7.8 Llsaa Caiacel-key 

Entry of this key causes the current line of input to be ignored. Most programs, 
upon recognizing this key, will erase the characters being ignored. 

7»9 Character Delete-key 

Entry of this key causes the last character entered from the keyboard to be 
deleted. For consoles whose class code is not zero this deletion is performed by 
physically erasing the character from the screen with a backspace, space, backspace 
sequence. 

r«I.O Oomsole Display—fast 

This key "backs out" one Console Display -slow key until the output to the console 
-S at its maximum speed. 

'"•11 Ccsssole Display— slow ■ 

'Lntry of this key causes the display to the console output device to be slowed down 
"vy delaying the output process after each character is output. 

.kitrj of this key the first nine times will add one millisecond between the display 
f each character. Entry of this key the next ten times will add one hundreth of a 
econd between the display of each charcter, etc. 

^'.le console output rate set by these two control keys is a SYSGENable function. 

12 Cdisole Scre€3i Wait 

lis control key is a toggle command. Toggling this key on will cause the output 
.1 the console device to "wait" after each page is displayed by positioning to the 
3 ttom left-hand corner of the screen, displaying an up-arrow C"), and waiting for 
.3 operator to type a key. When the operator has typed a space or return key the 
itput to the Console continues with the next page* 

oggling this key off will disable this "wait" feature. 
ifB is a SYSGENable function* 
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Syst^R Control Keys 



I Function 



J Key sequence 



System Restart-key * 


ESC, I * 


System Cancel-key 


ESC,Q 


Printer Echo-key 


ESC,P 


Console Echo-key 


ESC,0 


Program Pause-key 


ESC,S 


Program Cancel-key 


ESC,C 


Debug Break-key 


ESCjD 


Line Cancel-key 


CTRL/X 


Character Delete-key 


left -arrow 


or 


CTRL/H 


or 


DEL 


or 


RUB 


Console Display -fast 


ESC, A 


Console Display -slow 


ESC,B 


Console Screen Wait 


ESC,W 



Control Keys 



* Single-user OASIS only. 



When a reference is made to a control key or 
defined in a consistent manner: 



key sequence the key will always be 



!• Keys that need to be entered in sequence will be separated by commas; 
for example: ESC,Q means that the escape key is typed followed by the 
'Q' key. 

2. Keys that need to be entered simultaneously will be separated by 
slashes; for example: CTRL/SHIFT/A means that the three keys control, 
shift, and 'A' must be typed simultaneously* To accomplish this it is 
easiest to type and hold the control key, and while the control key is 
still held down type and hold the shift key, and while both of these 
keys are held down type the 'A' key. 





f 


4^ 


0$- 


^ 


■4* 




.^ 


.*• 


*/ ' 


4 






mn^^ 


mr 






esc 






em^cL 







TAft 



Mi 0^ 
Mi f«) 



Crr^i A3 

t£TAL )CJ 
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The notations used to define the command syntax in this and associated manuals are 
defined in the following paragraphs. 

Trtsaeaticyii and Abbreviation of CknMiaands 

When abbreviation of a command is permitted, the shortest acceptable version of the 
command is underscored. To determine the acceptable abbreviations refer to the 
chapter "SHOW Command", SYNONYM function. The example below shows the format 
specification for the COPYFILE command. 

CpPYFILE 

This representation means that C, CO, COP, COPY, COPYF, COPYFI, COPYFIL, and 
COPYFILE are all valid specifications for this command name. 

Command options are specified in the same manner- Where abbreviation is permitted, 
the shortest acceptable form of the option is underscored. If no minimum 
abbreviation is indicated, the entire word must be entered. 

5-p'Scial Boc^saiseiitatioii Characters ' 

The following symbols are used to define the command format and should never be 
typed when the actual command is entered. 

vertical bar j 
brackets [3 
ellipsis ... 

iCiditlo^iallyj angle brackets (<>) are used to enclose a term denoting that that 

:erm is to be replaced with one or more specific terms. For example: <fd> is 

rap laced with the specific directory label or disk label such as — -A, B, S, DATAl, 

^j'^eelal Characters for OiSIS ■ . ' 

uppercase letters and words, and the symbols listed below, should be typed as 
necified in the command format. 

asterisk * 
comma , 

'.qua! sign = 

parentheses ( ) 

erlod 

>lon : 

'i^v: -:,. cfiexactera ■ 

jjwercase letters j words, and symbols that appear in the command format represent 
ariables for which specific information should be substituted. For example, 
':.ie~desc" indicates that file identifiers such as "MYFILE.EXEC:A" should be 

.aterea'* 
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Co^^nds with Choices 

Choices are represented in the command formats by stacking or separation with the 
vertical bar. 

A ONJOFF 

B 

BracJcets 

The use of brackets denotes optional choices, one of which may be selected. 

For example, the representation 

[A] 
[B] 

rc3 

indicates that the user may code A, B, or C, or he may omit the field entirely. 
Ellipses 

An ellipsis indicates that the preceding item or group of items may be repeated 
more than once in succession. 

For example, the representation 

(<option>. • . ) 

indicates that more than one option may be coded within the parenthesis. 

4^br<e-¥latiosus Used 

The following abbreviations are used throughout this manual and when used will 
always have the meanings defined here. 

file-desc File description. Indicates that the file name, file type and file 
disk are to be inserted here. 

fn File name. 

ft File type. 

fd File disk label. Indicates which disk contains the file. The disk 
may be identified by either the label that is ATTACHED to the 
directory or the label written on the disk by the INITBISK command. 
This parameter is normally optional. 

ch Input /Output channel. 

drv Disk drive number such as 1, 2, 3, ETC. 
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pin Partition identification number. Indicates the number of the memory 
partition associated with a user. 

fr From. Usually used in a command that allows a from - to range to be 
specified. 

n A lowercase n or group of n's indicates that the operator may type a 
number. This number may be entered in decimal or hexadecimal (see 
section on Numeric Parameters). 

Maioing Coaventions 

All command names, file names, file types and options must meet the following 
requirements : 

a. All characters must be alphabetic, numeric or the dollar sign $. 

b. The first character must be a letter character. 

c. The length of each field may not exceed eight characters. If the 
field exceeds eight characters, the extra characters are truncated 
without any indication to the user. 
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CHAPTER 9 
THE COMMAND STRIHG IHTERPRETHL 

9.1 The CSI Proi^tixig Character 

The Command String Interpreter (CSI) accepts input from the system keyboard and 
transfers control to the various command programs. The CSI is in control 
immediately after a system boot and its control is indicated by a prompting greater 
than character (>) at the left side of the screen. 

9.2 CSI Forraat 

An OASIS command, as seen by the CSI, consists of a command name, usually followed 
by one or more positional operands and, in some cases, by an option list. The 
general form for the command is: 

command name [operand .••] [(option ...[)]] 

You must use the proper delimiters to separate the entries in the command line. 

These delimiters are - a period or space before a file type; a colon or space 

before a file disk; a left parenthesis before the first option; a comma or space 
before all other entries. 

9 .3 The Coaaeand Haiae 

The command name is an alphabetic symbol of not more than eight characters. In 
general, the names are English verbs which describe the function you want the 
system to perform. For example you may wish to make a backup of a disk. In this 
case you would use the BACKUP command. Or you may want to list a file on the 
system printer. To do this, you would use the LIST command with the option PRINT. 

'^-4 The Comgrnsd Operands 

Tae command operands are keyword and variable symbols no longer than eight 
alphameric characters. These keywords and variables specify the information on 
.?hich the system operates when it performs the command function. In the LIST 
command, you would use the file name and file type operands to specify the file to 
^e listed. 

'ome commands require no operands, others require several. The command syntax and 
•11 operand requirements are specified in the following chapters. 

.du must enter the operands in the order in which they appear in the command 
.•ormiats, unless otherwise indicated. 

• 5 The CoasBiaad Options 

Jhe command options are keywords used to control the execution of the command. The 
.ommand formats in the following chapters show all the options for each coraaand. 

'he option list must be preceded by a left parenthesis - a closing parenthesis is 
ot necessary. 

xf conflicting or duplicate options are specified, the last option entered is the 
option in effect for the command. Exceptions to this rule exist in the COPYFILE 
and INITDISK commands. 
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9»5.1 Default Optioias 

To specify that you want the default options for a command, enter the command name 
and operand. It is not necessary to enter the left parenthesis unless you wish to 
include some of the non-default options. 

9.5.2 Cosan&nts in the CSI 

You may enter comments with OASIS commands by preceding the comment with the 
semi-colon character (;). The Command String Interpreter ignores all characters 
after the semi-colon, including the semi-colon. 

9.6 CSI Prograa Search S^uc^nce 

The Command String Interpreter has a predetermined search sequence when it is given 
a command to search for. When you type a command the CSI will search for the 
command program in the following sequence: 

1. Search the system disk for a program with the same name as that 
entered, and file type COMMAND. 

2. If ABBREV is set ON then search the system abbreviation table for a 
match between the spelling of the command typed and the full command 
name. When a match is found step 1 is repeated. 

3« If a user SYNONYM table has been defined then search the user synonym 
table for a match with the user synonym and, if ABBREV is also ON, 
the abbreviation specified in the table. If a match is found step 1 
is repeated. 

4. If IMPEXEC is ON then the system disk is searched for a file with the 
name as typed and a file type of EXEC If a file is found the 

EXEGutive procedure processor is invoked to interpret the commands in 
the EXEC file. 

5. If ABBREV is set ON and a user SYNONYM table has been defined then 
step four is repeated using any matching abbreviations found in the 
file. 

6. The above five steps are repeated for each of the attached disk 
drives, in ascending, alphabetic sequence. , 

7. If no command program or EXEC has been found the CSI will display an 
error message. 

Once a program file has been identified and loaded into memory, control of the 
system is transferred to this program. 

9.7 CSI Ftmctiooal SmmatTf. 

The following tables present a functional summary of the cocmiands available to the 
OASIS user. They are described in detail in the following chapters. 
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Ccfwsaaids for Disk Malnteaaiice 

Gommand Function 

BACKUP Copy an entire disk. 

INITDISK Initialize a disk for use by OASIS. 

RECOVER (Optional) Find and restore a file to it's directory. 

REPAIR (Optional) Detect and correct disk mis -alio cat ion. 

Comaands for File Maintenance and Control 

Command Function 

ASSIGN Make I/O channel assignments. 

ATTACH Logically connect a device for future access. 

GOPYFILE Copy one disk file to another disk file. 

CREATE Create a new file with direct or indexed format. 

DUMPDISK (Optional) Display the physical contents of file is hexadecimal and ASCII. 

EDIT (Optional) Create or update a file from terminal input. 

ERASE Delete an existing file. 

FILELIST List the names and attributes of the files in a directory. 

GETFILE (Optional) Transfer a sequential file from a CP/M compatible disk. (CP/M 

is a registered trade mark of Digital Research.) 
KILL (Optional) Remove a file from the directory without deallocating its 

space. 
LIST Type the contents of a file on a console or printer. 
MOUNT Allow a disk to be changed. 

PEEK Peek at another users console output. 

RENAME Change the name, type, or protection status of a file. 

SECTOR (Optional) Display sector numbers used by a file. 

STATE Determine the existence of a file. 

TEXTEDIT Create or update a file from terminal input. 

CosMffiQid^ to Develop and Maintain Programs 

Command Function 

BASIC (Optional) Create or update a BASIC source program. 

DEBUG (Optional) Dynamic debugger for machine language programs. 

EDIT (Optional) Create or update a source program. 

FILT8080 (Optional) Translate Intel assembly mnemonics to Zilog mnemonics, 

compatible with the OASIS MACRO Assembler. 

INTELHEX (Optional) Convert Intel object code to OASIS object code. 

LINK (Optional) Translate with editing, an object program file to a load image 

(COMMAND) file. 
MACRO (Optional) Translate an assembly language source program to an object 

program. 
PATCH Correct minor problem in a load image file (COMMAND) program. 
RELOCATE (Optional) Create a relocatable object file from two absolute object 

files. 
TEXTEDIT Create or update a text file. 
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Command Function 



ACCOUNT Maintain user account names and attributes. 

CHANGE Change the privelege value of a program. 

LOAD Load a re-entrant comniand for subsequent usage. 

0V7NERCHG Transfer ownership of a file to another account. 

SET Enable /disable various system switches. 

SHARE Enable /disable shared access to file by other accounts. 

SHOW Display the status of various system switches and parameters 

SPOOLER (Optional) Change or display status of the printer spooler. 

START Initialize a user partition and allow user to logon. 

STOP Deinitialize a user partition. 

SYSGEN Save status of OASIS parameters on disk. 

UNLOAD Remove a re-entrant command from memory. 



Cossnands for System Blaga&ostlcs 



Command Function 



MEMTEST (Optional) Diagnose memory. 

SEEK (Optional) Test random sector reading of a disk. 

VERIFY (Optional) Test readability of a disk. 



CoisaaiaidbB to Exscote Frojprans 



Command Function 

BASIC (Optional) Execute a BASIC program. 

EXEC Execute an EXEC program. 

FORCE Cause another user partition to execute a command. 

RUN (Optional) Execute a BASIC compiled program. 

SCHEDULE Execute a command at a later date and time. 
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Command Function 



MAILBOX Retrieve message sent by other users. 

MSG Send a message to another user(s). 

RCCEIVS (Optional) Accept and save a file from another system. 

GE^^ (Optional) Send a file to another system. 

I'ERHINAL (Optional) Cause system to act like a terminal to another foreign system« 
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ACCOUNT C019i4m} 

The ACCOUNT command provides the ability to fflaintain the SYSTEM. ACCOUNT file. This 
file is special in the sense that it doesn't belong to any account and can only be 
maintained by this command. The format of the ACCOUNT command is: 

ACCOOIT [(optionl)]] 

As is seen, this command format is different from other command formats in that no 
file description is allowed. 

IMPOaTMX: USE OF TSIS iXmmMBi IMPLIES CERTAIN S£S?(HISIBILITI£S. BE SDSE THAT YOU 
UMBERSTAMD THE COHSSQUESCES 0? OELETIMG, ADDIH6, OR CHMGHiG ACCOUNTS BEFORE USING 
THIS COMHAMD- 

MXOXmr Options 

TYPE Indicates that the current SYSTEM. ACCOUNT file is to. be displayed on the 
console. 

PRINTER [nj Indicates that the current SYSTEM. ACCOUNT file is to be displayed on the 
primary printer or PRINTERn if n is specified. 

CLEAR Indicates that the account history file (SYSTEM. HI STORY) is to be 
transferred to the public file ACCOUNT. HI STORY. Any previous 
AC COUNT. HI STORY file owned by the system will be erased. 

HISTORY Indicates that the current SYSTEM. HISTORY file is to be displayed on the 
console (default) or the printer if the PRINTER option is also specified. 

The listing of the history file includes the following information: time 

and date of entry, entry type, account name, account number, partition 

identification number, . and elapsed time. Refer to the appendix "System 

Files" for more information about the SYSTEM. HI STORY file. 

KILL Indicates that the user accounting feature of the system is to be 
disabled. When this option is selected two questions will be asked of the 
.perator. These questions must be answered correctly for the accounting 
feature to be disabled. 

The user accounting feature is disabled by physically removing certain key 
programs and files from the system disk. Once this has been done the user 
accounting feature cannot be re-enabled without changing to an archive 
copy of the system. 

T.ils option should be used with great discretion for another reason: any 
-vccounts active in the system (files or programs owned by accounts other 
lian the system) will be inaccessible after the accounting feature is 
.<ILLed- To avoid this situation you must use the OT^ERCHG command to 
vransfer ownership of the active account's files and programs to the 

system account. The SHARE command must also be used to remove any shared 
file access » 



The two questions asked by this option are: 

Bo you wish to remove the accounting feature? 
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Do you ever wish to use the accounting feature again? 

The first question must be answered with a Y and the second question must 
be answered with a N before the accounting feature will be KILLed. 

COPY=fd Indicates that the current SYSTEM. ACCOUNT file is to be copied to the disit 
on the drive specified by fd. This is an easy means of transferring an 
accounting structure to another system disk. 

When no option is specified in the command line the account maintenance option of 
the command is invoked. This maintenance option allows for the addition, deletion, 
and changing of account names, passwords, and privilege levels. 

When the ACCOUNT command is in the maintenance mode the program is interactive. 
The specific maintenance mode is determined by the operator's answer to the 
question: 

Mode (Add/Change/Delete/End)? 

Answer this question with the appropriate letter: A for adding an account, C for 
changing an existing account, D for deleting an existing account, or E for ending 
the maintenance session. 

The add, change, and delete modes all ask for the account name to be specified. 
When the mode is add the account name entered must not be on file. When the mode 
is change or delete the account name must be on file. 

AsM Mode 

In the add mode the program asks if the new account is to be a synonym to an 
existing account. If it is then enter the existing account name that it is a' 
synonym to. Synonyms to existing accounts mean that the synonym account has access 
to all of the files that the primary account has access to. A synonym account has 
its own password and privilege level associated with it. 

If the new account is not to be a synonym of an existing account then enter a 
carriage return only in response to the synonym question- Whether or not the new 
account is a synonym to an existing account the program will ask for the password 

to be associated with the new account. The rules for the con^josition of a password 
are the same as for file names. If the new account is not to be password protected 

then do not enter a password. 

Next the program asks for the privilege level associated with the account. The 
privilege level is a number in the range of 0-5 but you are only allowed to specify 
privilege levels less than or equal to your current privilege level. 

After the above information is entered the program returns to the Mode question. 

The change mode of maintenance allows the operator to change the current password 
and privilege level associated with an account name. To delete the password type 
the number sign character (#) in response to the password question. 

Delete Mode 
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The delete mode will remove the account name specified from the SYSTM. ACCOUNT file 
and return to the Mode question. 

Care should be exercised when deleting an account name. The system maintains 
accounts not by name but by a number that it assigns to new accounts. When an 
account is deleted any files it may have had will not be accessible* If a deleted 
account is later re-added it will probably be assigned a different number than it 
had previously and the files will still be un-accessible. (In fact, it is probable 
that a completly different account name will be added at some time that is assigned 
the same number by the system. When this happens any files still in the system 
with the old deleted account's number will suddenly belong to the new, unrelated 
account.) 

Therefore it is advised that before deleting an account a check should be made to 
see if that account owns any files. If so the files should be transferred to 
another account with the OWNERGHG command or erased from the system. 

It is okay to delete an account if a synonym to that account still exists (synonym 
accounts are accounts with the same number but a different name). 

End Mode 

During the maintenance session all additions, changes, and deletions are kept 

internally to the program. To cau y^ the SYSTEM. ACCOUNT file to be updated with the 
changes the END mode is used. If, instead, the System Cancel-key is entered none 
of the additions, changes, or deletions will be made to the file. 

Examples 

>ACCOUNT 

Mode (Add/Ghange/Delete/End)? A 

Account name? PRIVATE 
Synonym name? 
Password? SUPERMAN 
Privilege? 3 

Mode (Add /Change /Delete /End)? A 

Account name? STARTREK 

Synonym name? PRIVATE 
Password? KIRK 

Privilege? 

Mode (Add /Change /Delete /End) ? D 

Account name? STARWARS 

Mode (Add /Change /Delete /End)? C 

Account name? PRIVATE 
Password? # 
Privilege? 

Mode (Add/Change/Delete/End)? E 
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>ACCOUNT (TYPE) 

Account Password Priv Id 



IPL 

PRIVATE 

STARTREK KIRK 
SYSTEM 





3 2 

2 

3 I 



In the above example session the account PRIVATE is added with a password of 
SUPERMAN, and a privilege level of 3» Next a synonym is added by adding the 
account STARTREK as a synonym of PRIVATE. This synonym has the password KIRK and a 
privilege level of 0. This synonym account will be able to access all of PRIVATE'S 
files (and vice versa) but, because of its lower privilege level, will not be able 
to access all of the programs in the account or in the public account. 

Next the account STARWARS is removed from the system. This will have no effect on 
any synonyms that STARWARS may have had. Finally the password for the account 
PRIVATE is removed. 
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AssiGH cowsmo 

The ASSIGN command provides the ability to make I/O channel assignments outside of 
an OASIS program. This means that a program can be written that is more general in 
purpose. Before the program is executed you would use the ASSIGN command to 
specify the files that the program is to use. The format of the ASSIGN command is: 

ASSIGH r<ch>|* <f:Ile^esc>l<devlce>|CI^] ^y 

Where: r^' ^^ r '^^ 

ch Indicates one of the I/O channels numbered from 1 to 16. ^h-^'^ 

* Indicates that all I/O channels are to affected. This specification is 

only valid with the CLEAR function. 

device Indicates one of the I/O devices available to the system. The device 
names are listed in Appendix B. The device name DUMMY is a special name 
that means that the channel is assigned but there is no input or output 
device associated with it. A program accessing the device DUMMY will act 
as though the access was performed but nothing will have been output or 
input. 

CLEAR Indicates that the I/O channel is to be unassigned. If an asterisk was 
used for ch then all channels will be cleared of assignments- 

You may use the ASSIGN command with no channels or devices specified. In this 
situation the system will display on the console all of the current channel 

assignments. 
ASSIGN EsusjkjXcs. 

>ASSIGN 1 FILE1.TYPE1:A 

>ASSIGN 2 FILE2.TYPE2:A 

>ASSIGN 3 PRINTER 

>ASSIGN 4 CONSOLE 

>ASSIGN 

1 FILE1.TYPE1:A 

2 FILE2.TYPE2:A 

3 PRINTER 

4 CONSOLE 

>ASSIGN 2 OASIS .DOCLTMENT:B 

>ASSIGN 

1 FILE1.TYPE1:A 

2 OASIS. DOCUMENT :B 

3 PRINTER 

4 CONSOLE 

>ASSIGN 3 CLEAR 
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SYSTEM BEFEESSCE HABOAL 

>ASSIGN 

1 FILE 1. TYPE 1: A 

2 OASIS. DOCUMENT :B 
4 CONSOLE 

>ASSIGN * CLEAR 
>ASSIGN 
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The ATTACH command is used to associate physical device drivers with logical device 
names. This allows the operating system to be configured to the specific 
peripherals available. Additionally, this command allows you to dynamically change 

the actual device of I/O without making changes to any programs. The format of the 
ATTACH command is : 

ATTACH [<logdev> [<phydev> [(<optloiis>... [)]3]] 

Where: 

logdev Is the logical device name of the device to be attached to the physical 

device. 

phydev Indicates the physical device name of the device, such as CRT or LP (line 
printer) etc 

The ATTACH command attaches physical device handlers to logical device names. 
These logical device names must be one of the names known to the system. These 
names are listed in the following tables. 

A logical device is not really a device or peripheral. It is merely a common 
communication link from an application program to a specific physical device. The 
logical device is only a pointer to the specific device's driver program and is 
accessed by using the logical device name. In this manner programs gain a great 
deal of flexibility: an application program need only reference the logical device 
name, such as PRINTERl, to perform input /output ; no programming is required by the 
application program to accomodate the requirements of the physical device. In this 
case the /PRINTER' may actually be a paper tape punch; tape drive, etc. 

Another attribute of a logical device is the general device class* For example: a 
disk drive is a random access, file structured, read/write device; a. printer is a 
sequential, record oriented, write only device; a tape is a sequential, record 
oriented, read/write device; a console is a sequential, character oriented, 
read/write, 'softcopy' (CRT) device with cursor addressing abilities; etc. 

Logical devices may be detached by using the ATTACH command with no physical device 
specified. Logical devices may be re-attached to another device without first 
detaching the device. Physical devices may be attached to more than one logical 
device name at any one time (except for disks). 
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Name 



Synonym Restrictions-Definition 



Options 



CON IN 




CONOUT 




CONSOLE 




S 




A thru G 




PRINTER 1 


PRT 


PRINTER2 


PRT2 


PRINTERS 


PRT3 


PRINTER4 


PRT4 


READER 


RDR 


PUNCH 


PCH 


COMMI 


COM 


C0MM2 


COM2 


C0MM3 


COM3 


C0MM4 


G0M4 


TAPEl 


TAP 


TAPE2 


TAP2 


TAPE3 


TAP3 


TAPE4 


TAP 4 



Console input (keyboard) 

Console output (screen, etc) P,L,C 

Combines both CONI & CONO P,L,C 

System disk HjSTPjSTS^R 

Disks H,STP,STS,R, PUBLIC 

P,L,0,ALF,PP 
P,L,0,ALF,PP 
P,L,0,ALF,PP 
P,L,0,ALF,PP 

Character oriented, input device 

Character oriented, output device 

Communications 

Communications 

Communications 

Communications 

Record oriented device 

Record oriented device 

Record oriented device 

Record oriented device 



Pfr^slcal Device Haxes 



Name* Synonym* Restrictions-Definition 



Options 



CRT VDM Video Display Monitor 

KEY KB Keyboard 

5101 SIO Serial I/O port 

5102 thru SI08 Serial I/O ports 
PIOl LP or PIO Parallel I/O port 
PI02 thru PI08 Parallel I/O ports 
DISKl thru DISKS Disk drives 

Physical device driver numbers 



nn 



B,LF,FF,PO,PE,ENAB 
B,LF,FF,PO,PE,ENAB 



H,STP,STS,R, PUBLIC 
Any that may apply > 






* Specific names and synonyms are determined by the SYSTEM. DEVNAMES file. 
OASIS Implementation Guide for your specific configuration. 



Also see 



The system disk (S) may be re-attached to the same or a different disk drive. When 
the attachement is to the same drive the attach program will request that you mount 
the new system disk on that drive. When this has been done the system will find 
the location of the various programs on the new system disk. The new system disk 

must have all required system files and a NUCLEUS of the same version as the old 
system disk. 

When the attachment is to a different drive the ATTACH program will not ask you to 
indicate when the disk is mounted. 

When the serial port is attached the number of stop bits generated for each byte 
transmitted is dependent upon the baud specified: a baud of 110 causes two (2) 
stops bits; a baud greater than 110 causes one (1) stop bit. This is generally 



ATTMM 



- 42 - 



SYSisa? 



CHAPTER 12: MTACa CC^^fASea 

consistent within the data processing industry. 

When a physical device is attached for the first time the device driver program (a 
SYSTEM file) is loaded into high memory, removing that memory from general use. 
Detaching a device will unload the device driver (thus freeing up memory) if, and 
only if, the device is not attached to another logical name and the device driver 
is the last driver loaded in memory (driver at top of stack). 

The ATTACH command cannot he used from BASIC or EDIT to attach a device for the 
first time (except disk drives). 

The ATTACH command allows you to attach disk drives out of sequence. This means 
that you may have drives S, D, and G attached without having drives A, B, C, E, and 
F attached. In addition the drives may be detached with no regard for other disk 
attachments. 

All device attachments are SYSGENable. If the following disk attachments have been 
made and SYSGENed: 

S DISKl 
A DISK2 
D DISK4 
G DISK3 

and the system is re-booted with the system disk in a drive other than DISKl, the 
system will automatically detach all drives equal to the system disk. For example, 
if the above system were re-booted with the system disk in drive 3 the attachments 
would be: 

S DISKS 
A DISK2 
D DISK4 

li^en a device is attached in the multi-user OASIS it is a private device, i.e., 
only the user attaching the device may access it. An exception to this is a disk 
device which may have an option of PUBLIC specified. 

AXTAGH OptlomB 

The ATTACH command allows various options to be specified when certain devices are 
attached. These options are available depending upon the physical or logical 
device being attached. The previous tables listed the options available for each 
logical or physical device. 

Bnnnn Indicates the BAUD (bits per second) of the serial device being attached. 
*~ When this option is not specified for a serial device the default BAUD of 

9600 is used. The available BAUDs that may be specified include: 110, 

300, 600, 1200, 2400, 4800, 9600, 19200, 38400. 

Note: Not all system support programable baud rate generators. This 
option is only effective when such a generator is used. For other systems 
a hardware change (a switch setting or solder dip header) must be made to 
change the baud- 

PO Indicates that the serial device requires odd parity communication- 
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PE 



Indicates that the serial device requires even parity communication. 
When PO or PE is not specified then no parity is used- 



The options B, PO, and PE only apply when 
the serial ports (SlOn)c 



a device is attached to one o^ 



Cn 



Indicates the class of terminal or printer. Many terminals have special 
codes to control the cursor or forms. The class code numl^ei:' specif ies 
which SYSTEM. CLASSnn file to use for translation of the codes used by the 
specific terminal. The class code may only be specified for the CONO 
device. 



If you need to use a terminal as a console and it is not one of the 
terminals currently implemented then refer to the appendix on "Terminal 
Class Codes" and the OASIS MACRO Assembly Language Reference Manual for 
details on how to write your own SYSTEM. CLASSnn file to control your 
terminal. 

The class codes currently available for terminals are listed in the 
appendix "Terminal Class Codes" at the back of this manual* Due to the 
time lag between implementing new class codes, documenting them and 
getting the documentation printed there may be more class codes available 
than are actually listed in that appendix. 

ENAB [n] Indicates that transmission on the serial port is to use a specific 
handshake protocall in the output direction only. There are four 
protocalls known to OASIS serial drivers: 

ENABl Monitor the DTR line (data terminal ready). When this line has 
a true status a character will be output to the device. This is 

the most efficient handshake protocall used by, OASIS. 

ENAB2 Each line of data sent to the device is terminated with a DCl 
character. Transmission of another line of data is not begun 
until a DC3 character is received from the device. 

ENAB3 Each line of data sent to the device is terminated with an ETX 

character. Transmission of another line of data is not begun 
until an ACK character is received from the device. 



FFnnn 



ENAB4 Monitor the CTS line (cleK'KK' has a true status a character 
will be output to the device. 

Note: Enable options 1 and/or 4 may not be supported by your 
system. 

Indicates the number of milliseconds (one thousandths of one second) 
required by the device to execute a form feed. The range of this value 

may be between and 63999 (up to 64 seconds). The default value is zero. 
This option may be specified in addition to the ENABLE option — both will 
be in effect* 



Lnnn Indicates the line length for the listing device being attached. When 
this option is not specified the default value for the specific device is 
used- Normally the default is 80. 



ATTACH 



■S¥S28S^ 



CHAPrm 12: AXTACa OmSMIB 



LFnnn 



Pnnn 



Onn 



ALF 



PP 



Indicates the number of milliseconds that the system is to pause after 
outputting a carriage return or line feed character to the device. The 
range of this value may be between and 63999 (up to 64 seconds). The 
default value is zero. This option may be specified in addition to the 
ENABLE option — both will be in effect. 

Indicates the page size of the device being attached. This value is used 
when the system is outputting data to the device. The value indicates the 
number of lines of data that are to be transmitted before a page eject 
command is given. When this Option is not specified the default value for 
the specific device is used. Normally the default is 56. 



This option and the L 
performing the output. 



option have no effect when a user program is 



Indicates the overflow size of a listing device* The overflow size is the 
number of lines between the last print line of a page and the first print 
line of the next page. The specification of this option implies tU the 
listing device does not have a form feed capability. Most listing devices 
do have form feed capabilities. The default for this option is zero, 
implying that the device does have form feed capability. 

This option specifies that the listing device has an automatic line feed 
upon carriage return. When this option is not specified OASIS will append 
a line feed character to a carriage return character on output (unless 
ANSI forms control is specified and the no line advance control is used). 
Most listing devices can optionally set the Auto Line Feed off. 

This option specifies that you wish page parity to be maintained on the 
listing device- Page parity means that a report or listing to the device 
is to contain an even number of pages (an extra form feed is performed, if 
necessary). This option is useful in causing reports to start on an 
"infold". When page parity is in effect the listing device is assumed to 
be at the correct page when a file is opened to it. 



PUBL IC Indicates that the disk is to be attached with public access, i.e., all 
users may utilize the disk. When this option is not specified the disk 
may only be used by the user attaching it. This option may only be used 
when in single user mode. 

Rnn Indicates the number of disk errors that may occur consecutively before a 
message is displayed on the console. 

Hnnn Indicates the number of milliseconds required for disk head load time. 
This option is used to fine tune the disk driver to your specific set of 
disks. 

STPnnn Indicates the number of milliseconds required for track-to-track disk head 
Step time. This option is used for fine tuning the disk driver to your 
specific set of disks - 

STSn nn Indicates the number of milliseconds required for disk head settle time. 
This option is used for fine tuning the disk driver to your specific set 
of disks . 



Since there is actually only one physical device driver for all of the disks an 
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option specified for one disk applies to the others. 

12.1 Physical Device Synofnjms 

Physical device names, synonyms, and general attributes are contained in the systei 
file SYSTEM.DEVNAMESlS. The OASIS system is distributed with the standard device 
names listed in the table above. You may change, delete or add device names and 
synonyms by editing this file. 

Refer to the Appendix on "System Files" for details about this file. 

12.2 OptJbBdLsing Disk Access 

Performance of your system may be significantly improved by using the proper step 
time, step settle time and head load time. The system, as distributed, is set for 
the times recommended by the disk drive manufacturer. Although this does insure 
that the disk access will be reliable it might not give optimal performance. 

If you wish to try to get more performance out of your system you are advised to 
try using lower STP and STS values. A suggested method of doing this is to lower 
the values a little bit, perform a SEEK test (or any other operation that moves the 
disk heads around a lot). If no errors are reported then lower the values a little 
more and retest it. If any errors are reported then raise the value back up to the 
last value that didn't report any errors. 

Vlhen you have found the values that give you fast and reliable disk access use the 
SYSGEN command to save that setting. 

Note: Each drive may require different values. Test each drive separately and 
SYSGEN the proper values after they are determined. 

ATTACH Ezasif}les 

>ATTACH READER SIOl 

>ATTACH PRINTER PIO (L66,PP 

>ATTACH A DISK3 

>ATTACH 

Options 

"SYSTEM$ ",avail=10K,dirsize=80,STS6, Public 

** Not Mounted ** 

"DATAl ",avail=247K,dlrsize»16,STS8,WP 

L63,P15,C5 
PRINTER! LINE-PRINTER L66,P56,PP 

The above exaw^le illustrates the use of the ATTACH command to show the current 
attachments. For attached disks additional information is given about each disk, 
under the options column- The first field in this column is the label of the disk, 
next is the available capacity of the disk, the capacity of the directory, and 
whether the disk is write protected. 

Note: The phrase "Not mounted" may appear. This has no relationship to whether or 
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Name 


Device 


S 


DISKl 


A 


DISK3 


B 


DISK2 


CONIN 


KEYBOARD 


CONOUT 


CRT 
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not a disk is mounted in the drive. It only means that the system has not accessed 
the disk since the last mount was performed aad therefore does not know the label 
information, etc The disk is attached! 
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The BACKUP command allows you to copy the entire contents of a disk to another 
disk. This is usually done on a periodic basis for protection or archive purposes. 
The format of the BACKUP command is : 

BAGEPF [<fdl> <fd2>3 C(MO¥ERXFT[)] ] 

Where: 

fdl Indicates the directory label of the source disk. 

fd2 Indicates the directory label of the destination disk. 

NOVERIFY Indicates that the information written on the destination disk is not to 
be verified (no read after write). 

If you omit fdl and fd2 then OASIS will perform the backup from the drive attached 
as 'S' to the drive attached as 'A'. 

When the BACKUP program is entered the source and destination directory labels are 
displayed for confirmation. If the displayed directory labels are correct enter a 
carriage return to indicate that you have loaded your disks and are ready to 
continue. If the drive labels are incorrect then enter an 'N', carriage return. 
The program will then ask you to enter the new source and destination drive codes. 

The BACKUP program next informs you of the disk labels of your source and 
destination disks and waits for confirmation. If the disk labels are of the disks 
that you intended to backup enter a carriage return and the backup process will 
proceed. If the disk labels are incorrect enter an 'N', carriage return, and t]r 
program will redisplay the drive labels. 

After the disks have been copied the BACKUP program asks if you wish to backup 
another set of disks. If you do then enter a 'Y' , carriage return and the cycle is 
repeated. If you do not wish to copy another disk then enter a carriage return. 

BACKUP performs an automatic MOUNT of the source and destination drives before and 
after a disk copy. 

Note; If, after the backup operation is complete, a SHOW DISK of the destination 
reports a +8 mis -allocation, then the backup operation did not go to completion. 
Retry the BACKUP procedure, making sure that it goes to completion. 

[ The BACKUP command may only be used to copy a privately attached disk to another | 
[ privately attached disk or to copy from or to a public disk while in single user [ 
j mode- I 

The following example illustrates the display of the BACKUP command. 
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>BACKUP 

Source on drive S(l) 
Destination on drive A(2) 
Mount disk now (Y/N) ~ N 

Enter new source drive code - A 
Enter new destination drive code - B 

Source disk is labeled "DISK1234" 
Destination disk is labeled "DISK4321" 
OK to start copy (Y/N) - Y 

End of copy, again (Y/N)? - Y 

Source on drive A(2) 
Destination on drive B(3) 
Mount disks now (Y/N) - Y 

Source disk is labeled "LABELl " 

Destination disk is labeled "LABEL 2 " 
OK to start copy (Y/N) - Y 

End of copy, again (Y/N) - N 
> 
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The CHANGE program provides a means of changing the privilege value of OASIS system 
programs- The format of the command is: 

mmGE <file-desc> (PRIV <mMi>£)J 

Where: 

nnn Indicates the value that the programs privilege value is to be set to. 
The range of values that a privilege value may be set to include to 5. 

Note that this command requires the option PRIV to be used, unlike other commands 
where options are optional. 

The file-desc must be of an absolute or relocatable program file. 

Ivben this command is executed the privilege value of the program specified by 

file-desc is changed to the value indicated. Afterwards that program may only be 

executed if the current system privilege level is equal to or greater than the 

privilege value of the program. , 

You may not change the privilege value of a program if the current privilege value 
of that program is greater than your current privilege level. 

Refer to the appendix on Privilege Levels for further information. 

Example: 

>CHANGE TEXTEDIT COMMAND S (PRIV 2 
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The COPYFILE command allows you to copy one file to another, copy groups of files, 
copy a file or group of files from one disk to another, or copy selected records of 
one file to another. The format of the COYPFILE command is; 

COFYFILE <fHe--descl> [<f ile-desc2>J [(<optlon»>[)] ] 

or 

COFTFILE <devl> <flle-de»c2> C (<Optiofis> C) } J 

or 

OOPYFELK <file-descl> <dev2> £(<c?i cloim>£)I} 

or 

ODPTTILK <devl> <dev2> {(<optloiis>{)]] 

Where : 

<file—descl> Indicates the file description of the source file. Wildcards are 

acceptable. The file disk must be specified explicitly or with an 
asterisk as the syntax of this command is position dependent. All files 

that you have access to (private, public, and shared) may be source files. 

<file~desc2> Indicates the file description of the destination file. An equal sign 
is acceptable for each element, indicating that the source file's 
description is to be used. Destination files are always private files. 
If the source file is a shared file then the destination file description 
must be different than the source or an error will occur. (A shared file 
has a directory entry in your account name. The copy process detects the 
existing file entry but cannot erase it as it is not trully yours.) 

:devl> Indicates the logical device name or the I/O channel number of the source 
file. 

dev2> Indicates the logical device name or the I/O channel niimber of the 
destination file. 

Optionally you may specify only one file description. This is interpreted by the 
"OPYFILE command as indicating an in-p lace file translation. 

WIFUaS Options 

:^tions for the COPYFILE command are as follows: 

^fFS Indicates that the results of each file copy is to be displayed on the 
console. This is a default option. 

JOTYPE Indicates that the results of each file copy are not to be displayed on 
the system terminal. When this option is not specified the source and 

destination file descriptions are displayed on the console along with the 
copy type ("copied to", "replaces", "appended to", etc.). 
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NEWDATE Indicates that the destination file(s) is to use the current system date 
for its directory entry. 

GLDDATE Indicates that the destination file{s) is to use the date from the 
directory entry of the source file for its directory entry. This is 
default option. 

MOUNT Indicates disks must be changed before the copy can be performed. When 
this option is specified COPYFILE will pause before beginning the copy, 
display the message "Change disks now" and wait for the operator to type a 
carriage return before performing the copy. 

PUBL IC Indicates that COPYFILE is to allow public files to be Included in the 
source files. 

VERIFY Indicates that COPYFILE is to verify its copy by performing a read after 
write. 

NOVE RIFY Indicates that COPYFILE is not to verify its copy. This is a default 
option. 

^UERY Indicates that COPYFILE is to ask you on a file~by-file basis, if the file 
is to be copied. A reply of Y is required for the file to be copied- 
This is a default option if the source file description includes 
wildcards. 

NOgUERY Indicates that COPYFILE is to copy each file that matches the 
specifications without asking the operator for permission. This is a 
default option when the source file description is explicit. When this 

option is not used and the input file description is not explicit (use" 
wildcards) the COPYFILE program will display each file description tha 

matches the specification and ask (query) the operator if the file is to 

be copied. 



NEWFILE Indicates 
files. If 
file specification 
option. 



that destination files are not to replace any pre-existing 
a destination file specification is identical to an existing 



then the copy is not performed. This is a default 



REPL ACE Indicates that the destination file may replace a pre-existing file of the 
same specification. This is a default option only when an in-place file 
copy is specified. Note: DELETE protected files may not be replaced (see 
the RENAME command). 



The following options may be used only when the source 
sequential in format (not direct or indexed). 



and destination files are 



APPE ND Indicates that the output is to be appended to a pre-existing file of the 
same specification. If no file exists with the same specification then 
one is created. Note: WRITE protected files may not be appended to (see 
the RENAME command). 



FROM nnn Indicates the first record to be copied from the source file, 
decimal record number and must follow the option FROM. 



nnn is the 
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FRLA BEL xxxxxxxx Indicates the first record to be copied from the source file, 
xxxxxxxx is a character string which appears at the beginning of the first 
input record to be copied. This string may be up to eight characters in 
length and may not include imbedded blanks. If the source file does not 
contain a record that starts with this character string then no records 
will be copied. 

FOR nnnn Indicates the number of records that are to be copied including the first 
record qualifying. 

TOLA S EL xxxxxxxx Indicates the last record to be copied from the source file. 

xxxxxxxx is a character string which appears at the beginning of a record. 
The record containing this string is not copied but indicates that no more 

records from this source file are to be copied. This string may be up to 
eight characters in length and may not include imbedded blanks. If the 
source file does not contain a record starting with this string after the 
first qualifying record then the remainder of the file is copied. 



TRUNC Indicates that trailing blanks 
before the record is copied. 



from each input record are to be removed 



NOTRU NC Indicates that trailing blanks from each input record are not to be 
removed before the record is copied. This is a default option. 

PACK Indicates that repetitive characters in the source file are to be coded 
and packed before copying. All consecutive occurrences of two or more 
blanks in the input records are encoded as a two character sequence. All 
consecutive occurrences of four or more other characters are encoded as a 
three character sequence. 



UNPACK Indicates that encoded 
normal format. 



repetitive characters are to be expanded into the 



When neither PACK nor UNPACK is specified the copy will be performed 
without any compression or expansion of repetitive characters. 

LOWG ASE Indicates that all uppercase characters in the input records are to be 
translated into their lower case equivalents before being copied. 

UPC AS E Indicates that all lower case characters in the input records are to be 
translated into their upper case equivalents before being copied. 

TRANS Indicates that a character translation is to be performed on the source 
file as it is copied. When this option is specified COPYFILE will display 
the message "Enter Translation List" on the console terminal and accept 
input from the operator. The prou^ting character in this mode is the 
right parenthesis. 

The translation list consists of pairs of characters entered from the 
console, separated by one or more blanks. Each character may be specified 
by typing the character itself or by typing its two digit hexadecimal 
equivalent . 
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The translation list may be continued onto additional lines by typing '-H-' 
as the last two characters of the line. This indicates that the 
translation list is continued on the next line- All characters after '-H-' 
on the line are ignored — may enter a comment after the -H-. A line may not 
be continued in the middle of a character pair. 

Note 1: When file-descl is a file that has READ protection (see RENAME command), 
the file must be copied in its entirety. This means that the following options are 
not valid when a READ protected file is being copied: FROM, FRLABEL, FOR, TOLABEL, 
TRUNC, PACK, UNPACK, LOWCASE, UPCASE, APPEND , and TRANS. 

Note 2: When a file is copied in its entirety the destination file will have the 
same protection status as the source file. When a file is not copied in its 
entirety (any of the options listed in Note 1) the destination file will have no 
protection status set (except option APPEND which will not affect the protection 
status of the file being appended to). 



Examples 



>COPYFILE DAVID. LETTER :S = = A 

DAVID. LETTER :S copied to DAVID. LETTER: A 

>CO?YFILE * BASIC :S =-- = A 
PROGl. BASIC: S Okay to copy (Y/N)? N 
PR0G2.BASIC:S Okay to copy (Y/N)? Y 
PR0G2. BASIC :S copied to PR0G2.BASIC:A 
PROGRAMS. BASIC:S Okay to copy (Y/N)? N 

rCOPYFILE PR0G1.BASIC:S PR0G2. BASIC :S (APPEND 
?RQGi .BASIC: S appended to PR0G2. BASIC: S 

>C0PYFILE PROGRAMS. B AS IC:S PR0G2. BASIC: S 
JR0GRAM3.BASIC:S not copied to PR0G2.BASIC:S 
because file exists 

>C0PY PROGRAMS. BASIC :S PROG 2.= :S (REPLACE NOTYPE 

>GOPY FILE! TEXT S NEWFILEl « A (FRL THE FOR 99 APPEND 
':iLEl. TEXT :S appended to NEWFILEl. TEXT: A 

;C EXAMPLE FILE S « = A (TRANS 

"".nter Translation List: 

y^ \ •^+• TRANSLATE UP-ARROW TO BACKSLANT 

)- , -R- TRANSLATE PERIOD TO COMMA 

15? 2E -H- TRANSLATE UNDERSCORE TO PERIOD 



VCOPYFILE COMMl PRINTERl (TRUNC 
>COPYFILE COMMA DATA .FILE: A 
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The CREATE command allows you to create new indexed or direct files- It is the 
only means of doing so. The CREATE command cannot be used to create a sequential 
format file — you must use the TEXTEDIT, EDIT, COPYFILE programs or write a 
program to do the sequential file creation. The format of the CREATE command is: 

CREATE <file-iiesc> (<opticjii>».* I)] 

Where; 

file-desc Indicates the file description of the file to be created* Wildcards are 
not allowed, and the file disk must be specif ied- 

CHEATS Opticma , ■ 

INDEXED Indicates that the file is to be created as an indexed access file. 

MRECT Indicates that the file is to be created as a direct access file. 

CLEAR Indicates that the indexed or direct file (one must be specified) already 
exists and that the current file is to be cleared — set to binary zeros - 
The existing file's filesize, record length and key length will be used. 

F^ILESIZE nn Indicates that the decimal number nn is the number of records the file 
is to contain. The maximum number of records per file is 65535. 

If the file is a direct file then this number is the actual filesize. If 
the file is an indexed file then the CREATE program will create a file 
with at least this many records. The actual filesize will be determined 
by an algorithm required by the system's access method. See the appendix 

"Indexed and Direct Files". 

JplCLEN nn Indicates that the decimal number nn is the physical length of each 
record in the file. The maximum length of a record in the system is 512. 

This length is exclusive of any key length specified* 

^YLEN nn Indicates that the decimal number nn is the length of the index key. 
KEYLEN may only be specified for INDEXED files. The maximum length of a 

key is 128. 

The CREATE command requires contiguous available space on the disk to create a 
file* If the largest contiguous available space is not large enough to hold the 
Tile being created the message **Disk full" is displayed. 

'Jhe CREATE command sometimes appears slow to execute. This is due to the fact that 
CREATE not only creates the file but also initializes the entire file space to be 
ull or empty records. 

The number of blocks allocated to the file by the CREATE command is dependent upon 
the FILESIZE, RECLEN, and KEYLEN options. 

vftien the file is a direct file then the allocation will be: 

Allocation = RECLEN * FILESIZE / 1024 , rounded up. C'^''^ klooks (rf (Ol^H 
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When thp file is an indexed file then the allocation will be: 
Allocation = 

2 * FILESIZE / 1024 , rounded up 

+ '■■•■ 
(2 + RECLEN + KEYLEN) * FILESIZE / 1024 grounded up 

To compute the FILESIZE for a restricted allocation area the following formula 
should help: 

(avail) * 1024 

FILESIZE = — • 

RECLEN + KEYLEN + 4 

CEEATE £x£ai|iles: 

>CREATE CUSTOMER MASTER A (INDEXED FILE 2000 REC 64 KEY 30 

>GREATE TRANSACT. DETAIL: ACCOUNTS (DIRECT FILE 9760 REC 32) 

The first example will create an indexed file on drive A with space for 2003 
records; length of key is 30 characters; length of record is 64. The number of 
disk blocks required for this file will be 192. 

The second example will create a direct file on the disk labeled ACCOUNTS with 
space for 9760 records of length 32. The number of disk blocks required for this 
file will be 305. 
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The ERASE command allows you to remove your own private files from the system. The 
format of the ERASE command is: 

ERASE <file-desc> [(<option>... t)]] 

Where: 

file--desc Indicates the file description of the file or files to be erased. 
Wildcards are acceptable. 

ERASE Options 

TYPE Indicates that the file description of each file erased is to be displayed 
on the console. This is a default option. 

NOTYPE Indicates that the file description of each file erase;; is not to be 
displayed. 

^UERY Indicates that the operator will be asked (queried) on a file by file 
basis if the file is to be erased. This is the default option when the 
file description is not explicit. 

NOQU ERY Indicates that the operator is not to be asked on a file by file basis if 
the file is to be erased. This is a default option when the file 
specification is explicit. If this option is not specified and the file 
description is not explicit (wildcards used) the file description of each 
file that matches the specification is displayed on the console and the 
operator is asked (queried) if the file is to be erased. Only a response 
of Y will cause the file to be erased. 

The system will not allow this command to erase a file that has DELETE protect 
status. If a file has DELETE protect status you must first use the RENAME command 
to change the protect status. 

Care should be taken if the file is shared by another account. If the file is to 
be erased and not re-added in the near future the operator should first use the 
SHARE command to verify if any other users have shared access to the file. If 
another account does have shared access the SHARE command should be used to remove 
this access before the file is erased. Having shared access to a deleted file may 
cause problems in the other account. 



Examples 



>ERASE F* * A 

FILE1.BASIC:A Okay to Erase (Y/N)? N 
FILELIST. COMMAND: A Okay to Erase (Y/N)? Y 
FILELIST. COMMAND: A Protected 

>ERASE X* * A 
No files erased 
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>ERASE F* * A (NOT 

FILE I.BASIC: A Okay to Erase (Y/N)? Y 
FILELIST. COMMAND: A Okay to Erase (Y/N)? Y 
FILELIST. COMMAND: A Protected 
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The FILELIST command allows you to display the directory entries for files in your 
account. The format of the FILELIST command is: 

FILSLIST (<flle-desc>i<fd>3 I(<optloa>-.. [)] ] 

Where; 

<f ile-desc> Indicates the file or files to be included in the directory search and 
list. Only files in your account will be included. To include files in 
the public account you must use the asterisk option. Wildcards are 
acceptable. 

<fd> Indicates the directory label or disk label of the disk to be searched. 
When fd is omitted all of the ATTACHed directories will be searched. An 
fd without a file name or file type indicates that all of the files on the 
specified directory are to be listed. Only files in your account will be 
included, unless the asterisk option is used and then only files in your 
account and the public account will be included. 

<blank> When the file-desc or fd is not specified all directories, all file names, 
and all file types are included in the listing. 

Blrectory Fields 

The directory contains all the information necessary for the system to maintain the 
files. This information is contained in a directory entry for each file. Most of 
the information is displayable by the FILELIST command. This information includes 
the following columns in the order listed here. 

En^sae This is the file name as defined earlier. 

Ftype This is the file type as defined earlier. 

Brv This is the directory label as assigned by the ATTACH command. 

Bate This field is updated with the current system date whenever the file is 
changed, created, or appended to by a user program or by one of the OASIS 
commands. 

T3j» Similar to the date field. 

Note: Your system may not support the time of day feature- 

Eiec3 This field indicates the current number of records in the file. For 
direct files it is the total file allocation as specified at creation 
. time. 

BIkB This field indicates the number of 1024 byte blocks in use by the file. 
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FormgLt This column contains two parts: 

A character specifying the physical format of the records in the file. 
The character indicates its format is: 

S Sequential 

I Indexed access 

D Direct access 

R Relocatable command 

A Absolute command 

This character is followed by any protection status set for the file: 

D Delete protected 
W Write protected 
R Read protected 

The second part indicates the length of the records in the file. For 
sequential files it is the length of the longest record in the file as the 
file may contain records of variable length. For direct and indexed files 
it is the length as specified at creation time. 

Label This is the disk label as assigned by the INITDISK command. 

Sect This field is the starting sector number of the file and is only displayed 
when the asterisk option is specified. 

Other This field is only displayed when the asterisk option is specified and 
contains two columns: the first column is a numeric value and the second 

column is a letter code indicating what the first column is. The letter 
codes are as follows: 



E 
L 

F 

FILELIST OptlossB 



- Indicates that the preceding number is the ending sector number 
of the file (only for sequential files). 

- Indicates that the preceding number is the length of the 
program file (only for relocatable program files). 

- Indicates that the preceding number is the origin address of 
the program file (only for absolute program files). 

- Indicates that the number is the allocated filesize of the file 
(only for indexed data files). 



FNAME Indicates that the list is to include only the file name column. 

FTYPE Indicates that the list is to include the first two columns: Fname, and 
Ftype. 

FpISK Indicates that the list is to include the first three columns: Fname, 
Ftype, and Drv. 

DATE Indicates that the list is to include the columns: Fname, Ftype, Drv, 
Date, and Time. 

Note: Your system may not support the time of day feature. 
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ALLOC Indicates that the list is to include the columns: Fname, Ftype, Drv, 
Date, Time, Recs, and Blks. 

FORMAT Indicates that the list is to include the columns: Fname, Ftype, Drv, 
Date, Time, Recs, Blks, and Format- 

LAEEL Indicates that the list is to include the columns: Fname, Ftype, Drv, 
Date, Time, Recs, Blks, Format, and Label. 

When none of the above seven options is specified the FILELIST command 
will display as many columns as can fit in a line on the device. This is 
determined by the attached line length. 

J^ (Asterisk) Indicates that the listing is to include all information 
contained in the directory for both the public files and the files owned 
or shared by this account. Unless this option is specified only the files 
owned or shared by this account will be included in the listing. 

This option must be used if you wish to have the Sect and Other columns 
displayed. 

TYPE Indicates that the listing is to be displayed on the system console. This 
is a default option. 



PRINTER [n] Indicates that the listing is to be displayed 
not specified then PRINTERl is used- 



on the printer. If n is 



EXEC Indicates that the listing is to be written to disk and given the name 
'SELECTEB.EXECrS'. This option may not be used with the option OWNER. 
When EXEC is specified the default for fields included is FDISK. The 
records created in this file contain 9 variables for use when the file is 
executed by the EXECutive procedure processor. This option and the change 
in default allows you to create a file of file descriptions to be used by 
the EXEC command as explained in the manual describing the EXEC language. 
The file created by this option can also be used by a user written 
program, of course. 

FILE Indicates that the listing is to be output to the system disk and given 
the name: SELECTED.FILES:S. This option may not be used with the option 
OWNER. This option is very useful for creating a data file of file names 
to be used by an application program. Similar to the EXEC option, the 
records created contain the filename, filetype, and filedisk unless 
another option specifies more or less information to be included - 

APPEND Indicates that the listing is to be APPENDED to a previously created file 
named SELECTED. EXEC: S or SELECTED. FILES :S. This option is used in 
con4unction with the EXEC or FILE option. 

HEADER Indicates that the listing is to include a heading at the top of each 
page. This is the default except when the EXEC option is specified or 
when less than the date column is listed. 

NOHE ADER Indicates that the listing is not to include a heading at the top of each 
page. This is the default when the EXEC option is specified or when less 
than the date column is listed. 
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NOSQ RT Indicates that the list is to be in the same sequence as in the directory. 
This option may not be used with the OWNER option. 

^ORT Indicates that the list is to be sorted by file name, file type, and file 
directory label. This is a default option. 

mm/dd/yy Indicates that only files whose update date is greater than or equal to 
this specified date are to be included. The date must be in normalized 
format: mm/dd/yy. 

OWNE R Indicates that all files that qualify to the file specifications are to be 
included, Independant of the file's owning account. This option may only 
be used if your privilege level is five or you are currently logged onto 
the system account. 

The output produced when this option is used will group the files by 
account owner with a page break between each account. (This option can 
only be used when output is to the console (TYPE) or printer (PRINTn), not 
with options EXEC or FILE.) The heading of each page of the listing will 
include the owning account name. Files owned by an account number that is 
not defined in the SYSTEM. ACCOUNT file will have a name of ????????. 

FILELIST Examples 

The following examples illustrate some of the options of the FILELIST command. The 
Date, Time, Recs, and Blks used in these examples do not necessarily reflect the 
current release of the operating system. 

Note: Your system may not support the time of day feature. 

>FILELIST * EXEC S (FD 
IPL EXEC S 
1 file(s), 1 block(s). 

>FILELIST S* * S (DATE) 

Fname • Ftype — Drv -Date- — Time- 



SET 


COMMAND 


S 02/11/80 22:55 


SHOW 


COMMAND 


S 02/12/80 


14:58 


SYSGEN 


COMMAND 


S 02/12/80 


22:49 


SYSTEM 


CSI 


S 02/11/80 


21:41 


SYSTEM 


DEV02 


S 02/21/80 


13:12 


SYSTEM 


DEVll 


S 02/21/80 


13:22 


SYSTEM 


DEV12 


S 02/21/80 


13:25 


SYSTEM 


DEV13 


S 02/21/80 


13:32 


SYSTiiM 


DEV9 


S 02/21/80 


13:07 


SYSTEM 


EXECSAVE 


S 02/22/80 


20:04 


SYSTEM 


NUCLEUS 


S 02/11/80 


15:57 


SYSTEM 


UPDATES 


S 02/12/80 


22:50 


12 file( 


s), Al block(s). 




>FILELIST D* * S 


(FNAME 




DtlMPDISK 








1 file(s 


), 2 block(s). 
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>FILELIST S 



Fname Ftype — Drv -Date — Time- Recs Blks Format- Label 



ASSIGN 


COMMAND 


S 


02/04/80 


22:33 


5 


2 RDW 


256 


SYSTEM$C 


ATTACH 


COMMAND 


S 


02/05/80 20:53 


13 


4 RDW 


256 


SYSTEM$C 


BACKUP 


COMMAND 


S 


02/06/80 


21:31 


5 


2 RDW 


256 


SYSTEM$C 


BASIC 


COMMAND 


S 


02/12/80 


22:44 


76 


19 RDW 


256 


SYSTEM$C 


COPYFILE 


COMMAND 


S 


02/05/80 


22:04 


20 


5 RDW 


256 


SYSTEM$C 


CREATE 


COMMAND 


S 


02/04/80 


12:32 


6 


2 RDW 


256 


SYSTEM$C 


DUMPDISK 


COMMAND 


S 


02/06/80 


22:27 


7 


2 RDW 


256 


SYSTEM$C 


EDIT 


COMMAND 


S 


02/02/80 


10:34 


54 


14 RDW 


256 


SYSTEM$C 


ERASE 


COMMAND 


S 


02/12/80 


15:11 


5 


2 RDW 


256 


SYSTEM$C 


FILELIST 


COMMAND 


S 


02/29/80 


22:16 


13 


4 RDW 


256 


SYSTEM$C 


INITDISK 


COMMAND 


S 


02/04/80 


12:25 


8 


2 ADW 


256 


SYSTEM$C 


IPL 


EXEC 


S 


02/24/80 


23:25 


2 


1 s 


12 


SYSTEM$C 


LIST 


COMMAND 


S 


02/08/80 


23:50 


15 


4 RDW 


256 


SYSTEM$C 


LINK 


COMMAND 


S 


02/08/80 


19:03 


10 


3 RDW 


256 


SYSTEM$C 


MEMTEST 


COMMAND 


S 


02/11/80 


20:53 


4 


1 RDW 


256 


SYSTEM$C 


MOUNT 


COMMAND 


S 


02/04/80 


15:48 


2 


1 RDW 


256 


SYSTEM$C 


PATCH 


COMMAND 


S 


02/30/80 


14:05 


9 


3 RDW 


256 


SYSTEM$C 


RENAME 


COMMAND 


S 


02/12/80 


16:43 


8 


2 RDW 


256 


SYSTEM$C 


RUN 


COMMAND 


S 


02/18/80 


22:55 


68 


17 RDW 


256 


SYSTEM$C 


SET 


COMMAND 


S 


02/11/80 


14:58 


6 


2 RDW 


256 


SYSTEM$C 


SHOW 


COMMAND 


s 


02/12/80 


22:49 


13 


4 RDW 


256 


SYSTEM$C 


SYSGEN 


COMMAND 


s 


02/12/80 


21:41 


2 


1 RDW 


256 


SYSTEM$C 


SYSTEM 


CSI 


s 


02/11/80 


13:12 


22 


6 ADW 


256 


SYSTEM$C 


SYSTEM 


DEV02 


s 


02/21/80 


13:22 


2 


1 RDW 


256 


SYSTEM$C 


SYSTEM 


DEVll 


s 


02/21/80 


13:25 


4 


1 RDW 


256 


SYSTEM$C 


SYSTEM 


DEV12 


s 


02/21/80 


13:32 


1 


1 RDW 


256 


SYSTEM$C 


SYSTEM 


DEVI 3 


s 


02/21/80 


13:07 


3 


1 RDW 


256 


SYSTEM$C 


SYSTEM 


DEV9 


s 


02/21/80 


20:04 


8 


2 RDW 


256 


SYSTEM$C 


SYSTEM 


EXECSAVE 


s 


02/22/80 


15:57 


8 


4 DD 


512 


SYSTEM$C 


SYSTEM 


NUCLEUS 


s 


02/11/80 


22:50 


55 


14 AD 


256 


SYSTEM$G 


SYSTEM 


UPDATES 


s 


02/12/80 


15:44 


133 


4 S 


44 


SYSTEM$C 


31 file( 


s), 132 block(s). 













>FILELIST S* * S (EXEC 
>LIST SELECTED EXEC S 



SELECTED. EXEC :S 



&1 SET 
&1 SHOW 
&1 SYSGEN 
&1 SYSTEM 
&I SYSTEM 
&1 SYSTEM 
&1 SYSTEM 
&1 SYSTEM 
&1 SYSTEM 
&1 SYSTEM 
&1 SYSTEM 
&1 SYSTEM 



COMMAND 

COMMAND 

COMMAND 

CSI 

DEVIO 

DEVll 

DEV12 

DEVI 3 

DEV9 

EXECSAVE S 

NUCLEUS S 

UPDATES S 



&2 &3 

&2 &3 
&2 S(3 
&2 &3 
&2 &3 
&2 &3 

&2 &3 
&2 &3 
&2 &3 
&2 &3 
&2 &3 
&2 &3 



&4 &5 

&4 &5 
&4 &5 
&4 &5 
&4 &5 
&4 &5 

&4 &5 
&4 &5 
&4 &5 
&4 &5 
&4 &5 
&4 &5 



&6 &7 

&6 &7 

&6 &7 

&6 &7 

&6 6f7 

&6 &7 

&6 &7 

&6 &7 
&6 &7 

&6 &7 
&6 &7 
&6 &7 



&8 &9 

&8 &9 
&8 &9 

&8 &9 
&8 &9 
&8 &9 

&a &9 

&8 &9 
&8 &9 
&8 &9 
&8 &9 
&8 &9 
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>FILELIST ??S??? * S (FN 

ASSIGN 

BASIC 

LIST 

SYSGEN 

SYSTEM 

SYSTEM 

SYSTEM 

SYSTEM 

SYSTEM 

SYSTEM 

SYSTEM 

SYSTEM 

SYSTEM 

13 file(s), 28 block (s). 

>FILELIST S (02/22/80 FD 

Fnaiae Ftype — Drv 

FILELIST COMMAND S 
iPL EXEC S 
PATCH COMMAND S 
3 flle(s), 8 block(s). 

>FILELIST SYSTEM DEV#* A (* 

Fname Ftype — Drv -Date — Time ^Recs Blks Format, Label -Sect Other — 

SYSTEM DEV13 S 02/09/80 14:25 3 1 RWD 256 BACKUP 1364 260 L 
SYSTEM DEV17 S 02/09/80 14:26 5 2 RWD 256 BACKUP 1364 801 L 
SYSTEM DEV18 S 01/13/80 18:18 5 2 RWD 256 BACKUP 1376 804 L 
jj file(s), 5 block(s). 
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FORCS CQMI&HD 

The FORCE command is only available on multi-user OASIS. 

The FORCE command provides a means of forcing another user to perform a task. The 
format of the command is: 



FORCS <piii> [<co3na2id>] 



j Where: 



I <pin> Indicates the partition identif icatln number of the user or account to be 

I forced. 

I 

I <command> Is the command that the user is to be forced to do. When the command is 

I not specified the user will be forced to exit from the program he is 

I doing. 

The FORCE command provides a useful, but dangerous, capability. Before using this 

J command to force another user to perform some task you should use all other means 

I to make sure that data or labor will not be lost. At the minimum, you should first 

I send a message to the user asking him to perform the task voluntarily. If the user 

I does not respond to this (away from console) then you should first check the status 

I of his partition (SHOW MEMORY) to determine what he is doing and whether it would 

I be okay to force him to perform your task. 

[ 

j When the FORCE command is executed the user specified is forced to execute his quit 

I error trap (system cancel-key) and, if a command was specified, execute the 

j command. 

I 

I Normally, the FORCE command would only be used to LOGOFF users to get in a mode 

I that would allow single-user operation. 

I .■ . . 

j It is possible that the user may have a quit error trap set such that his program 

I is not aborted (TEXTEDIT does this). In this situation the user will not be forced 

[ to perform the command until he returns to the CSI level. 
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The INITDISK command allows you to Initialize a disk for use or re-use by the OASIS 
operating system. The format of the INITDISK command is: 



IMI13>ISK i<£d>} C(<option>...l)]3 



Where: 



fd 



Indicates the disk drive containing the disk to 
is omitted A is assumed • 



be initialized. When fd 



IHi13)ISK Options 

Options for the INITDISK command include the following: 

LABEL Indicates that you only wish to re-initialize the disk label- 

change the label of a disk that is write protected' 



You may 



This is the only option which may be specified when the system disk (S) is 
being initialized. If the label of the system disk is changed, the system 
will respond with an error message: "Need System Disk". Enter a system 
restart to reboot. 

CLEAS. Indicates that you wish to initialize the directory space, erasing all 
existing files from that disk. This option is not valid when the system 
disk is initialized. 

FORMAT Indicates that you wish to initialize the format of the entire disk. The. 
formatting process entails the writing of track and sector addresses and 
data area consisting of a pattern of data. You may use this option on a 
disk that is write protected. This option is not valid when the system 
disk is initialized. 

BUILD Indicates that the disk is hard formatted and that you wish to only write 
a bootstrap sector, label sector, and directory to the disk. No other 
writing will be performed on the disk. 

BO0T«fd Indicates that the bootstrap loader is to be copied from the disk on drive 
fd instead of from the system disk. This option only operates in 
conjunction with the option FORMAT and can only be used on a system with 
three or more drives* 



l^JP 
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Indicates that the specified disk is to be write protected. "Etiis option 
must be used by itself. When a disk is write protected the operating 
system will not allow any changes to the disk by any of the coimaands or 
user programs. (INITDISK with option FORMAT ignores any write protection 
on a disk for obvious reasons.) 

Indicates that any disk write protection on the specified disk is to be 
removed. This option, when specif ied» must be used by itself. 
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SIZE Indicates the number of directory entries to be allocated in the new 
directory. This option requires the option CLEAR or FOR>IAT to be in 
effect. The SIZE option is followed by a number which is the desired 
number of directory entries. When this option is not specified a default 
directory size is used which is determined by the capacity of the disk. 
This option is not valid when the system disk is initialized. 

When the size option is used the INITDISK program will allocate at least 

the specified number of entries. More may actually be allocated due to 

requirements of the system. The minumum directory size is determined by 
the format of the disk. 

DICR Indicates the logical sector increment value. This option requires the 
option FORMAT and is followed by the number of the sector increment. 
Normally the default increment value is used (1) which causes a one-to-one 
mapping of physical sectors in a track to logical sectors. Changing this 

value might improve the disk I/O throughput (or degrade) by causing the 
sectors to be interleaved on a track which, when the rotational speed of 
the disk is taken into account, might optimize the consecutive sector 
read/write time. 

This option has no effect on disks that are "hard sectored". 

SKEW Indicates the offset between logical sector zero of one track and logical 
sector zero of the next track. This option requires the option FORMAT and 
is followed by the number of the track skew. Normally the default skew 
(0) is used which indicates that tracks are not skewed. Changing this 
value might improve the disk I/O throughput (or degrade it) when the track 
step-time is taken into account. 

This option has no effect on disks that are "hard sectored". 

HEAD Indicates the number of disk surfaces available on the disk. This option 
requires the option FORMAT and is followed by the number of surfaces. 

JjRACKS Indicates the number of tracks per surface available on the disk. This 
option requires the option FORMAT and is followed by the number of tracks. 

SECTOR Indicates the number of sectors per track available on the disk. This 
option requires the option FORMAT and is followd by the number of sectors. 

It is necessary that a new disk be FORMATted before attempting to write data upon 
it. , 

When a disk is FORMATed the options SIZE, INCR, SKEW, HEAD, TRACK and SECTOR do not 
have to be specified unless the default values are not correct. These values will 
be displayed before the initialization process begins. If the values are not 
correct respond with a "N" and the program will be exited, allowing you to restart 
and to specify the correct values. 



The actual 
system. 



default values is dependant upon the manufacturer of your computer 



The option WP for write protection is different from the hardware write protect. 
The hardware write protect is a function of the disk controller and the removal of 
the "write enable" tab on the disk itself. 
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While a disk is being initialized the current track number of initialization is 
displayed. 

>INITDISK A (FORMAT 

INITDISK will erase all files on drive A(2) 
Do you wish to continue (Y/N)? N 
Disk remains unchanged 

>INITDISK A (LABEL) 

Enter disk label: DISKIDX 

>INITDISK A (CL 

INITDISK will erase all files on drive A (2) 
Do you wish to continue (Y/N)? Y 

>INIT B (CLEAR SIZE 32 

INITDISK will erase all files on drive B(3} 
Do you wish to continue (Y/N) ? Y 

>INIT C (FORMAT SIZE 8 

INITDISK will erase all files on drive C(4) 
Do you wish to continue (Y/N)? Y 

Enter disk label: TEST 

Number of directory entries =32 
Increment between adjacent sectors == I 
Offset between adjacent tracks «= 
Number of surfaces =1 
Number of tracks/surface = 77 
Number of sectors /track =13 

Is above information correct (Y/N)? Y 
Track: 
■ > ' 
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CHAPTER 21 

LIST cammB 

The LIST command allows you to display data files on the console or the system 
printer. The format of the LIST command is: 

LIS T <file-desc> [(<optioia>..« [)] 

Where: 

file-desc Indicates the file description of the file to be listed. Mthough the 
file disk may be omitted, wildcards may not be used. 

The file may not be a binary program file and should not Be a BASIC 
compressed file (file type BASICOBJ or BASICCOM) . 

LIST Options 

Options for the LIST command include the following: 

reel Indicates that the list of the file is to start with this record number. 
This field must be numeric. When reel is greater than the number of 
records in the file no records will be listed. When this field is omitted 
1 is assumed and recn cannot be specified. 

recn Indicates that the list of the file is to end with this record number, 
inclusive. This field must be numeric or '*' and, when specified, must 
follow the specification of reel. When this option is not specified or is 
specified as an asterisk the list will continue until the end of the file 
is reached. 

TYPE Indicates that the list is to be output to the console. This is a default 
option. 

PRINTER [n] Indicates that the list is to be output to the printer specified. If n 
is not specified PRINTERl is used. 

HEADING Indicates that the listing is to include a heading. This is a default 
option. The standard heading, when specified, includes the file name, 
file type, file disk label, current system time and date, and the page 
number. 

NOHE AD Indicates that the listing is not to include a heading. 

INDENT n Indicates that the listing is to be indented nn columns from the left 
margin- If this option is omitted then the listing will be displayed 
starting with column 1. 

UPC AS E Indicates that all lower case characters are to be "folded" to their upper 
case equivalents. 

LOWCASE Indicates that all lower case characters are to be displayed "as is" 
without any translation. This is a default option* 

TRUNC nn Indicates that each line of data is to be truncated at column nn. The 
data truncated will not be listed on the next line. 
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jFOSMAT Indicates that the file contains ANSI forms control characters. Refer to 
the appendix on ANSI forms control. 

PAGE nn Indicates that the output of the listing is to be suppressed until page 
number nn is started- 

TITLE text Indicates that the listing is to include an alternate heading 
consisting of the text followed by the current system time, date and the 
page number. This option, when used, must be the last option specified as 
all characters following 'TITLE' will be treated as the text to the title. 
Any words in text will be truncated to eight characters by the CSI. 

OBJ Indicates that the file to be listed is an object file. The LIST command 
will interpret the file and display it in a readable format: record 
length, record type, pab number, record starting address, record data. 

Sequential format files are listed, one record per line (unless FORMAT option is 
specified). Direct and indexed format files are listed in a special format. 

For these files the key (ASCII key for indexed, record number for direct) is listed 
followed by a colon, space. The remainder of the record is then listed, taking as 
many lines as needed. The record contents will always be indented from the key. 

Files that have READ protection cannot be listed with this program (see RENAME 
command) • 

1.IST .SxaiBolass , 

>LIST TEST OBJECT (OBJ NOHEAD 

10 F 00 005C TEST 01 0100 
15 T 00 0100 2146O1361012147O1360O7EFE09D219O1 
15 T 00 0110 2146017EB7C20001FF5F160021480119 
15 T 00 0120 194S79234623965778239EDDA3F01B2CA 



02 Z 00 lAlA 

>LIST DATA FILE (NOHEAD 

This is record 1: ONE TWO THREE FOUR 
This Is record 2: ONE TWO FOUR 
This is record 3: ONE TWO THREE FOUR 
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LOAD COMfAND 

The LOAD command is only available on multi-user OASIS. 

The LOAD command loads a re-entrant program for subsequent usage. The format of 
the command is: 

LOAD <file-desc> 

Where: 

<file-desc> Indicates the re-entrant program to be loaded. When no file type is 
specified the default type of LOADFILE is used. When no file disk is 
specified the system disk will be searched first. 

This command may only be used in a single user environment (no user partions 
defined — see SET command). 

Before a re-entrant program may be used by multiple users the program must first be 
loaded into memory with this command. 

Up to eight re-entrant programs may be loaded at one time. 

After the re-entrant program is loaded with this command another program could be 
executed that checks to see if there is a re-entrant copy, and acts accordingly. 
An example of this is the BASIC. LOADFILE and the RUN.COMJIAND. The RUN command, 
when invoked by the CSI, is loaded and executed. One of the first operations that 
it performs is to ask the operating system if BASIC has been loaded. If it has 
I then it transfers control to it and releases its own memory for use by the 
[ re-entrant BASIC. If BASIC was not loaded then it continues operation as a 
non-re-entrant program. 

I 

I Do not load a re-entrant program unless it is to be used — all user's available 

I memory will be reduced un -necessarily. 
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LOGOFF - LOGOH COJMAUDS 

LOGOFF Cos^^md 

The LOGOFF command provides the primary means of changing accounts in the system* 
The format of the command is: 

LOGOFF 

When the LOGOFF command is executed the current account is logged off, a history 
record is written to the SYSTEM ,111 STORY file recording the log off time and elapsed 
logon time of the account « At this time control is transferred to the LOGON 
command described next. 

I The LOGOFF command detaches all of your private devices (except the console) and | 
i re-attaches the public disks. j 



JXmm Commnd 

The LOGON command provides the only means of changing accounts in the system. The 
format of the command is: 

I.OGOII <acct-iQaaie> 

IfJhere: 

acct-name Indicates the user account name to be logged on to. 

Iv%en the LOGON command is executed an automatic LOGOFF is performed on the current 
;iccount» This automatic LOGOFF is different from your execution of the LOGOFF 
command in only one area: no history record is written to the SYSTEM. H1ST0R.Y file 
tlie. previous account's elapsed time is transferred to the new account being logged' 
onto. 

The program searches the SYSTEM. ACCOUNT file for the account name specified. If 
uhe account name cannot be found the program will return to the "Logon please:" 
question. 

Wlien the account name is found in the SYSTEM. AC COUNT file and the account respires 
a password (not all accounts do) but the operator has not entered one yet, the 
program will ask for it: 

Password? 

Again, the password entered will not be displayed on the console^ asterisks will be 
ticed for each character typed. 

.'1 -he password Is incorrect the program will return to the "Logon please:" 
lestion. 

yhen the account name and password are correct the program sets the privilege level 
of the system to the privilege level of the account (see ACCOUNT command) and 
esets all of the SETable switchs to the SYSGENed condition. At this time the user 
: G logged on to the account specified and may only access public files and 
programs, his own private files and programs, and any files and programs that he 
has shared access to (see User Accounting and SHARE command). 
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A search is made of all attached directories for an EXEC program with the file 
description <acct-name>.EXEC. When this file is found it is executed. If the file 
cannot be found then control of the system returns to the CSX level. 

The LOGON command will not allow yOu to log onto an account that is already in use 
-J by another user. This applies to the account number, not just the account name, 
I therefore you may not log onto a synonym of an account in use by another user. 

I 

I The LOGON command resets the switches RDYMSG, ABBREV, IMPEXEC, and VERSION to the 
j status saved by the SYSGEN program. 

Examples: 

>LOGOFF 

Logoff at 12:23:15, on 02/07/79, ET =122.68 

Logon please: NAMES 

Password? ****** 

Logon at 12:23:20, on 02/07/79. 

>LOGON USER 

Logon at 12: 24.* 10, on 02/07/79 
>L0G 

Logoff at 13:12:10, on 02/07/79, ET = 15.24 
Logon please: NAMES,****** 
Logon at 13:12:15, on 02/07/79. 

> ■■ 

Note that the logon procedure is slightly different when performed following a 
LOGOFF. This is due to the fact that after the LOGOFF is executed there is no 
account logged on and the system will force the operator to log onto a valid 
account . When the LOGON command is executed and there is an error in the account 
or password the previous account is still logged onto the system. 
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j The MAILBOX command is only available on multi-user OASIS. 

i 

{ The MAILBOX command allows you to retrieve messages sent to you while you s^re 

j unable to receive messages. The format of the command is: 

1 I 

I HAII^BGX C<£ile-desc>3 I(<options>[)33 i 

1 1 

I Where: ! 

I I 

1 <flle~desc> Is the file description of the file to be used by MAILBOX to copy your j 

j messages. When this parameter is not specified, your messages will be } 

I displayed on the console or printer. j 

I 1 

j WHLmX Options \ 

! I 

I PjtllNTER [n] Indicates that your messages are to be displayed on the printer. j 

I I 

j APPEND May only be used when the <file-desc> parameter is specified. Indicates j 

j that the messages are to be appended to the end of the file specified by | 

{ <file-desc>, if that file already exists. Whea this option is not used j 

I the file will first be erased before your current messages are copied to j 

I it. I 

I I 

!■ ■■;■. .r 

j You have mail waiting. j 

[v ■■. I 

j >MAILBOX I 

[ I 

I From: TODD, 09:58 10/19/79 | 

j Sorry I missed you. I copied all of the programs you requested | 

j to your account. Hope that they will do the jpb. } 

1 I 

I >MAILBOX SAVE. MAIL (APPEND j 

\ >LIST SAVE. MAIL (NOHEAD I 

I I 

I From: SYSTEM, 10:15 10/19/79 j 

j Blease turn in all of your log sheets, to date. ! 

I- ■'■■■' ■ ■ . I. 

I From: MANAGER, 10:30 10/19/79 j 

j The system will not be available tomorrow,, the 20th due to installation [ 

j of additional disk capacity* \ 

! ' r 
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MOUNT ccam&m 

The MOUNT command allows you to inform the system that a disk is to be changed. 
The format of the MOUNT command is: 

MOUHT <fd>|* 

Where: 

fd Indicates the label of the directory that is to be changed. 

* Indicates that all attached disks may have been changed. (System disk (S) 
excepted). 

This command informs the system that a disk has been changed. The system maintains 
a copy of each disk ID that is attached. This provides a safeguard to the user in 
preventing disk changes during updates, etc If a disk is changed and this command 
has not been executed a disk error will occur: "Disk Changed". When this message 
is displayed and if is acceptable for the disk to have been changed then you may 
respond with an 'M', which will cause a mount to be performed on the drive. 

The system disk (f d = S) may not be changed at any time without re-booting the 
system. This is due to the fact that once a system disk has been booted several 
internal pointers in the operating system have been set* Resetting these pointers 
is essentially what occurs when the system is re-booted. 

Caution: The MOUNT command must be used when a change is made from a single density 
disk to a double density disk or from a double density disk to a single density 
disk. When such a change is made and the MOUNT command is not used the first 
access to the changed disk may cause the system to "hang". 

Note: Not all systems have the ability to detect a changed disk. This is a 
function of the disk drive and controller. On systems that lack this capability 
the MOUNT command will have no effect. 
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MSG cowsmo 

I The MSG command is only available on multi-user OASIS- \ 

\ ■ . ■.:■■ ' 

{ The liSG comcaand provides a means of sending a message to another user. The format 

j of the command is: j 

I ■ ":. .■ 1 

{ MSG <piii> <text> f 

\ , , ■■ r 

j Where: [ 

I I 

j <pin> Indicates the partition identification number or the user name that the { 

I message is to be sent to. A pin of * indicates that the message is to be | 

j sent to all logged on users, including the sender. You may only broadcast j 

j a message to all users if you have a privilege level of five. I 

I.. ^ [ 

{ <text> Is the message to be sent. When <text> is omitted the MSG command will j 

j allow you to enter multiple lines of text with the message terminated by a j 

{ blank line. 1 

I f 

I When the MSG command is executed the message specified by <text> will be displayed 1 

j on the user's console specified by <pin>. It is possible that this cannot be done. J 

I In this situation one of several messages may be displayed on your console: { 

i [ 

I Can't send message to your self. [ 

r . I 

j User is not receiving messages. [ 

^ '. ■ ■■' J- 

j User is not logged on. f 

I ■ : ' 

I In the latter situations where the receiving user is not logged on or has his 

I message switch set off (see SET MSG command) then the MSG command will ask you if | 

' you wish to put the message in the user's mailbox. (See MAILBOX command.) { 

i t 

i ■ ^ 

t >MSG 2 Please load the invoice forms in the jpr inter. (Send msg when done.) j 

! User is not logged on f 

j Do you wish to put this message in the mailbox (Y/K>? N | 

• ■ .■■ r 

j >MSG TOM Would you please send me a message when you log on? [ 

{■ ■■ -I 

j - >MSG * - I 

I Enter message text, terminate input by empty line. | 

[ tSystem reverting to single user mode at \ 

i ?5:30 for backup purposes. Please be logged [ 

! ?off by that time. f 

\ i 

From: SYSTEM f 

I System reverting to single user mode at [ 

; 5:30 for backup purposes- Please be logged | 

o£f by that time. t 
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The OWNERCHG command provides a means of transferring account 
or group of files. The format of the OWNERCHG command is: 



ownership of- a file 



GmmmG <file-desc> (<acct-iiaae> [<option> ...][)] 

Where: 

file-desc Indicates the file description of the file or group of files whose 
ownership is to be transferred. Only the current account's private files 
may be changed with this command. Wildcards are acceptable. 

<acct-name> Indicates the account name that the files are to be transferred to. 
Account names are validated against the SYSTEM. AC COUNT file. Invalid 
names are rejected with no changes made to any files. 



O^HKRCQG OptlonB 



TYPE 



Indicates 
console. 



that the results of the operation are to be displayed on the 



NOTYPE Indicates that the results of the operation are not to be displayed on the 
console- When this option is not specified the message "<file-desc> 
changed" is displayed for each file whose ownership is changed. 

^UERY Indicates that the operator is to be asked (queried) for confirmation 
before each file qualifying is changed. This is a default option unless 
the file description is explicit (no wildcards). 

NQQU ERY Indicates that the operator is not to be queried on a file by file basis- 
This is a default option when the file description is explicit. When this 
option is not specified and the file description is non-explicit (uses 
wildcards) the file description of each file matching the description will 
be displayed on the console and the operator is asked (queried) if the 
file is to have its ownership changed. A response of **Y" indicates yes 
and a response of "N" indicates no. 



Examples: 



>OWNERCHG MYFILE. BASIC :S (MINE 
MYFILE .BASIC :S changed 

>OWNERCHG * BASIC A CYOURS 

AARDVARK.BASIC: A Okay to change owner (Y/N)? Y 

File "AARBVARK.BASIGcA" is now owned by account "YOURS" 

BINARY.BASIC:A Okay to change owner (Y/N)? Y 

File "BINARY. BASIC: A" is now owned by account "YOURS" 

SATURDAY.BASIC:A Okay to change owner (Y/N)? Y 

File "SATURDAY. BASIC: A" is now owned by account "YOURS" 

APPLE. BASIC: A Okay to change owner (Y/N)? N 
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PATCH cmmjmii 

The PATCH command provides a means of implementing minor corrections to errors in 
object programs, such as the system programs- The format of the PATCH command is: 

?A3rCg <file-desc> 

The file specified by file-desc cannot be write protected and it must be a program 
file (absolute or relocatable in format). When the PATCH comniand is executed the 
specified program file is read into memory the PATCH prompt character (\) is 
displayed- At this time there are five subcommands available to the operator in 
addition to a HELP command. 

All addresses and numeric values specified in the following subcommands must be 
hexadecimal in format. 

28*1 Hwa^ Suhccmmaxkd 

The Dump subcommand displays portions of the program on the console. The format of 
the subcommand is: 

\Dump addrl [addr23 

Addrl specifies the beginning address to display. Addr2, when specified, indicates 
the ending address to display. When addr2 is not specified sixteen addresses will 
be displayed. 

The Dump subcommand always displays the program in lines of sixteen addresses each. 

2S»2 End StabcoKwaiad 

The End subcommand indicates that the "patch" is complete and the program is to be 
written back to disk. The format of the subcommand is: 

\End 

or , ■ , . 

AFile 

28.3 Quit SubcoaBMuad 

The Quit subcomsaand indicates that the "patch" is to be Ignored and that control is 
to be returned to the operating system. The format of the subcononand is: 

VQUIT 
2Sa4 BLei^Xaee S'Q.bcQnnemd 

The Replace subcommand specifies that the contents of an address is to be changed. 
The format of the subcommand is: 

\Replace addr value [value]... 

Addr indicates the first address to be modified by the list of values. When more 
than one value is specified or if the value is a character string, the values 
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replace the contents of the addresses following addr. 

The list of values may be of three types: 8 bit numeric, 16 bit numeric, or quoted 
character string. For example: 

8 bit numeric: 5 15 AO 3F 

16 bit numeric: (3900) (9F00) (1234) 

character string: 'Syntax error' 

28.5 Verify Subcoaraand 

The Verify subcommand allows you to verify the current contents of addresses. The 
format of the subcommand is: 

\Verify addr value [value]... 

This subcommand is similar to the Replace subcommand exc pt that the values are 
used for verification, not replacement. 

PATCH Example 

>RENAME SAMPLE COMMAND S (NOWRITE 
SAMPLE.COMMAND:S protection: DELETE, NOWRITE 

>PATCH SAMPLE COMMAND S 

\VERIFY 4900 C3 03 8F 

\REPLACE 4901 05 

\DUMP 4900 

4900: C3058FFD 215191AF E121235A E5211C54 ' .. . . !Q[. . !#Z. I .T' 

\VERIFY 8FE5 C3 52 8F 

\REPLACE 8FE6 (5000) 

\VERIFY 8FE5 C3 00 50 

\VERIFY 6000 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' 

mismatch 

\END 
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PEEK COmSMfO 

The PEEK command is only available on multi-user OASIS. 

The PEEK command allows you to see what another user is doing by copying his 
console output to your console. The format of the command is: 

PEEK <pin> 

Where: 

<pin> Indicates the partition identification number or user name of the user to 
be peeked at. 

When the PEEK command is executed all output to the specified user's console will 
be echoed to your console. If the user's console uses different screen control 
characters than yours the output may appear "funny". 

While the PEEK command is operating only the system control keys will be 
acknowledged from your console. The only way to exit from the PEEK command is to 
enter the System Cancel-key. 

The PEEK command should not be used to monitor another terminal for a long period 
of time as the system response does degrade. 
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The RENAME command allows you to change the filename, filetype, or protection 
status of your own private file or group of files. The format of the RENAME 
command is : 



Where: 



BmUME <old fd> [<new fd>] [(<optioii> ...[)]] 



old-fd Indicates the current file description of the file or group of files to be 
renamed. Wildcards are acceptable. 

new-fd Indicates the new file description to be assigned to the file or group of 
files qualifying to old-fd. Equal signs are acceptable for the components 
of the file description. The file disk must be an equal sign or the same 

file disk as specified in old-fd. 

When this parameter is not specified only the protection status of the 
file(s) may be changed. Protection statuses may not be changed when 
new-fd is specified. 

EEHilMB Options 



TYPE 



Indicates 
console. 



that the results of the operation are to be displayed on the 



NOTYPE Indicates that the results of the operation are not to be displayed on the 
console. When this option is not specified the new-fd of each file 
renamed is displayed on the console. 

^UERY Indicates that the operator is to be asked (queried) for confirmation 
before each file qualifying is renamed. This is a default option unless 
the file specification is explicit. 

HOQU ERY Indicates that the operator is not to be queried on a file by file basis. 
This is a default option when old-fd is explicit. When this option is not 
specified and the old-fd is not explicit (wildcards used) the file 
description of each file matching the old-fd is displayed on the console 
and the operator is asked (queried) if the file is to be renamed. Any 

response other than an "N" will be interpreted as meaning yes. 

jj^ELETE Indicates that the file is to have DELETE or erase protection. A file 
with DELETE protection miay not be erased or renamed without first changing 
the protection status. 

' -ODE LETE Indicates that the file is to have any DELETE protection removed from it. 

'jRITE Indicates that the file is to have WRITE protection. A file with WRITE 

protection ma;y not be updated without first changing the protection 
status- A file with WRITE protection may still be erased. To prevent 
this you should also specify the DELETE option. 

KOWR ITE Indicates that the file is to have any WRITE protection removed from it. 
READ Indicates that the file is to have READ protection. A file with READ 
SYSEEF ' - gl-. 
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protection can only be accessed by the RUN command. This protection mode 
cannot be removed from a file- Since the READ protection mode cannot be 
removed it is advised that the programmer maintain an archive copy of the 
program in case any modifications need to be m^de to the program. A 
program file with READ protection cannot be LISTed, EDITed, DUliPed, MOVEda' 
SCRIPTed, COPYFILEd (except in its entirety), or loaded by the BASIC 
interpreter. 

It is not necessary to specify WRITE protection in addition to READ 
protection as a file with READ protection cannot be accessed by any 
commands or functions that might try to write to the file. 

A file with READ protection may be deleted. 

Note: Do not use this command to change the file type of a BASICOBJ or BASICCOM 
program file — the file will be renamed properly but will be unuseable to BASIC. 

Example: 

>RENAME TEST BACKUP A = BASIC 
TEST. BACKUP :A renamed TEST. BASIC: A 

>RENAME AARDVARK.BASIC:A (READ 

AARDVARK.BASIC: A protection: NODELETE, NOWRITE, READ 

>RENAME TEST * S (NODELETE NOW 

TEST. COMMAND :S Okay to change protection (Y/N)? Y 
TEST. COMMAND :S protection: NODELETE, NOWRITE 
TEST. OB JECT:S Okay to change protection (Y/N)? N 
TEST.ASSEMBLE:S Okay to change protection (Y/N)? N 
TEST.BASIC:S Okay to change protection (Y/N)? Y 
TEST. BASIC: S protection: NODELETE, NOWRITE 
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CHAPTER 31 
SCHEDULE COMSAHD 

The SCHEDULE command is only available on multi-user OASIS. 

This documentation of the SCHEDULE command is preliminary and subject to change. 

The SCHEDULE command provides a means of scheduling a job to be executed at a later 
date and/or time. The format of the command is: 

SCHEQPLE <date> <tljae> <co!n«BUttd> 

Where: 

<date> Is the formated date that the job is to be performed on. 
<time> Is the formated time that the job is to be performed at. 

<command> Is the command name and options that is to be performed at the specified 
date and time. 

The SCHEDULE command, when executed, saves the information for subsequent action 
and then returns control to the CSI level. 

When a job has been scheduled the CSI checks to see if it is time to perform the 
job. This check is performed every time that you are at the CSI level. If it is 
time to perform the job then it automatically executes the saved command string. 

If you inadvertantly schedule a job with a date and time that has already occured 
then the job will be executed immediately. 
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SET comimB 

The SET command allows you to change various system parameters and options. The 
format of the SET command is: 

SET <f^mction> <statH»> 

Where: 

function Indicates one of the system functions or parameters that the SET command 
may alter. 

status Indicates the status or condition that the function is to be set to. 

SET Functions 

The various functions that the SET command may alter are defined as follows: 

SET ABBSKV QHlQFF 

This function allows the user to change the status of the switch that allows 
commands to be abbreviated. Normally commands are allowed to be abbreviated. 

,.,).■•, . ' ■■ 
For a description of the effects of changing ABBREV and SYiN refer to the chapter on 
the Command String Interpreter, CSI Program Search Sequence section. 

SET GMCEL na 

This function is similar to the SET ESCAPE function except that it operates on the 
line cancel key. 

SET CLSFEQ Hal ItrnZ} 

This function requires privilege level 5 or greater and provides an easy means for 
the user to fine tune the time of day clock. If, for whatever reason, the time of 
day is not accurate, this function may be used to adjust the physical Interval of 
time between "ticks" of the clock. The two values nnl and nn2 are used for gross 
and fine adjustments, respectively. Any values entered will replace the current 
values so it is advised that you use the SHOW CLKFRQ command to determine the 
current values first before adjusting them with the SET CLKFRQ command. 

Decreasing the value of either or both parameters makes the time of day clock run 
faster — Increasing the value of either or both parameters makes the time of day 
clock run slower. Decreasing one parameter and increasing the other parameter will 
have a combined effect on the speed of the time of day clock. 

SKI HME vm/Mljf 

This function requires privilege level 5 or greater and allows the user to change 
the system date. mm/dd/yy indicates that the user types the month., day, and year 
that he wishes the system date set to. 

Leading zeros are not required and the slash (/) delimeter may be replaced with any 
of the following characters ./-+*: i "#$%&'=§ V>? 
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SYSTEM EEFEaSUCK MMmM. 

SET ^ATmom l\Z\3 

This function allows you to set the format of the date display. The format set by 
this function will be reflected in the headings of listings, logon history, initis-^ 
date set on system start, etc. 

Format 1 mm/dd/yy 01/31/80 
Format 2 dd-nm-yy 31-01--80 
Format 3 ddmmmyy 31JAN80 

SET B©¥H mn 

This function is similar to the SET ESCAPE function except that it operates on the 

down-arrow key. 

SET EESMM OElOm - 

This function requires privilege level 5 or greater and allows the user to set the 
error number display ON or OFF. When a system program detects an error the er?^^- r 
is reported to the operator in one of three ways: error number and text; err-^r 
number only; error text only. This function will either turn ON or OFF the error 
number display. If you are turning the error number display OFF and the error text 
display is already OFF then the error text display will be set ON. (It is not 
allowed to turn both methods of displaying errors OFF.) 

SET- EBEIEOr ©ISfOFF 

This function requires privilege level 5 or greater and allows the user to set the 
error text display ON or OFF. When a system program detects an error the error ir 
reported to the operator in one of three ways: error number and text; error numbe| 
only; error text only. This function will either turn ON or OFF the error text 
display. If you are turning OFF the error text display and the error number 
display is already OFF, then the error number display will be set ON. (It is not 
allowed to turn both methods of displaying errors OFF.) 

Refer to the Appendix on System Errors for details on error disflay. 

SST ESJ^FE, sea 

This function allows the user to set the value of the character to be interpreted 
as the escape character from the console keyboard. Some terminals use the escape 
character for their own uses and do not transmit the charcter to the host computer. 
By using this function you can designate another character to be used as the escape 
character, leaving the escape key for the exclusive use of the terminal. The value 
an. corresponds to the ASCII value of a key. For exan^le if a CONTROL/Y is to be 

'4sed the value is 25 . 



^4:t53 fanction requires privilege level 5 or greater and allows the user to change 
*:he status of the switch that determines whether history records are to be created 
for each user logon and logoff. When history record creation is suppressed by 
setting this switch off the LOGON and LOGOFF commands operate somewhat faster 
Lacause less Work is done by them. 
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SET IMPEXEC OH|OFF 

This function allows the user to change the "switch" that allows a command to be 
the name of an indirect command file (EXEC). 

When IMPEXEC is set OFF, and the user wishes to execute an EXECutive procedure, the 
user must specify that he is doing so by preceding the name of the EXEC file with 
the command EXEC. 

When IMPEXEC is set ON the user need not explicitly specify that he is executing an 
EXECutive procedure unless the name of the EXEC is the same as one of the OASIS 
commands - 

For more information regarding the EXECutive procedure processor refer to the EXEC 
Language Reference Manual. 

SET LEFT an 

This function is similar to the SET ESCAPE function except that it operates on the 
left-arrow key. 

SET "mMMS <pia> C<leDgth> (<baxik>] ] [ 

This function requires a privilege level of 5 and allows you to define a partition | 
and its size. I 



! Memory partitions must be allocated in ascending order and deallocated in decending j 

f order within a bank's memory region. The memory used by the partition is taken [ 

j from or given to the next lowest user within the same bank. When multi-user OASIS | 

I is first booted into the system there is only one partition (number 1) that owns } 

?.ll of available memory (single user mode) in the first bank of memory. | 

i The SET MEMORY command is used to allocate or deallocate the users. For example, | 

1 if three users are desired, each with 12 thousand bytes of memory the following [ 

j commands might be given: } 

:■ . I 

>SET MEMORY 2 24000 I 

1: ■ ■ ■■ I 

I >SET MEMORY 3 12000 { 

[■ , ■ ■ ^ [ 

i At this time there would be three, inactive users with the second two users having J 

i .',2000 bytes of memory each and the first user having the rest of memory available. j 

; 7he minumum partition size is 4096. [ 

, !f vour system has more than one bank of memory you can use the optional parameter | 

<bank> to specify which bank of memory the user partition is to be allocated in. [ 

.;he first user allocated to a bank gets all of the banks memory (all banks are [ 

sized when the system is first booted up. When no bank number is specified the j 

default bank of zero is used. | 

;■■ . ''r 

' SET MSS OMjOFF ] 

■ i 

■ This function allows you to specify whether or not you are receiving messages* For | 

more information see the MAILBOX and MSG conmands. | 
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SET FEI¥ un 

This function allows you to lower the privilege level, thus restricting the 
commands and functions that you may perforin. Normally, this function would only 'he 
used in single-user OASIS when the accounting feature is not used. (The accounting 
feature allows you to specify a privilege level for each account name.) 

SET lBl!«Sa OMJOFF 

This function allows the user to set the ready message display either ON or OFF. 
When it has been set ON the system will display a "ready message" after the 
execution of every program. This message consists of the return code, current 
system time and the elapsed time of execution. 

This feature of the system can be useful if the user is testing a progrsr. that uses 
the return code in a decision making process. 

SE^ EIGHT tm 

This function is similar to the SET ESCAPE function except that it operates on the 

right-arrow key. 

SET ETCMAIL OHlCFF 

This function allows those users of systems that have implemented interrupts on a 
system that didn't initially have the interrupts to enable the time of day feature 
In OASIS. 

The interrupt mode implemented must be IMl and the frequency of the interrupt must 
be set with the SET CLKFRQ function. 

sm 'mmmt wa 

This function is similar to the SET ESCAPE function except that it operates on the 
Gharacter rubout or delete key. 

I: S.ET SLIC^ -mm f 

1 r 

I This function requires privilege level 5 or greater and allows you to change the | 
j time slice value. The time slice value is the number of 1/1000 of a second J 

I (millisecond) that each user will have control of the system. I 

1 ■■■■;■■■■ ■ \ 

I A typical slice time is in the range of 10 to 50 milliseconds. 1 

^^stmrnmifmi [(optionD]] 

'.'Ms function allows the user to change the command synonym table. 

tv-2 file name refers to the user defined synonym file. This file must exist before 
the user synonyms may be set ON. As described in the Appendix on System Files this 
^ile must have a file type of SYNONIM and be a sequential format file on the system 
/isk. Specifying a filename causes an automatic CLEAR option to be performed on 
any previously defined user synonym file. 

When a user defined synonym file is specified the user defined synonyms will take 
precedence over any system defined abbreviations* 

SIT - 88 — SYSS^ 
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The allowed options for the SET SYNONYM command include the following: 

NOSTD Indicates that the system defined synonyms are to be turned off. 
Since the system defined synonyms are only abbreviations of the 

system commands then this option effectivly sets ABBREV OFF for the 
system abbreviations but not the user defined abbreviations. This 
option has no effect on the user defined synonyms, if any. 

STD Indicates that the system defined synonyms are to be turned on. This 
option has no effect on the user defined synonyms, if any. 

CLEAR Indicates that the user defined synonyms are to be cleared. This 
option does not effect the status of the system defined synonyms. 

SET TIME bh:saM:ss 

This function requires privilege level 5 or greater and allows you to change the 
system clock. hh;nffli:s-s indicates that you are to type the hours, minutes, and 
seconds that you wish to set the system clock to. Typing the seconds is not 
required, nor are leading zeros. The colon (:) delimiter may be replaced with any 
of the following characters ./-I-*: r'#$%&'=@"<>? 

If you type an invalid or unrecongnizable time the SET command will reply: 

Invalid format for time S.B (HH:MM:SS) 

SET C? im 

This function is similar to the SET ESCAPE function except that it operates on the 
up-arrow key. 

SET VmSlGS OSjOFF 

This function allows the user to change the status of the version switch. When the 
VERSION switch is set on the program name, version number, and version date will be 
displayed upon entry to a program. 

SST Exmms^l&B 

>SET DATE 5-10.78 

>SET RDYMSG ON 

RC = 0, 12:15:32, ET = 15.3 minutes 

>SET RDYMSG OFF 

>SE ABBREV OFF 

>SE VERSION ON ; THIS SHOULD NOT ALLOW THE ABBREVIATION 
SE. COMMAND not found. 

>SET ABBREV ON 
>SET ESCAPE 22 
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SHARE cammo 

The SHARE command allows you to designate that a file is to be shared by another 
account. The format of the SHARE command is: 

SHMS <file-desc> [(<irype>[)]3 

Where: 

file-desc Indicates the private file whose shared access is to be modified. 

Type Indicates that the current shared access accounts to this file are to be 
displayed on the console. 

When the TYPE option is specified a list of account names that have shared access 
to this file will be displayed on the console. 

When the TYPE option is not specified the SHARE command will allow you to change 
the accounts that have shared access to the file specified. 

The program will ask "Add user account?". If an additional account is to be 
allowed shared access to this file then enter the account name and the question 
will be asked again for additional accounts. When no account name is entered in 
response to this question the next question will be asked. Do not specify a system 
account name as an account to have shared access. When a file is shared with 
another account it is also shared with all of that account's synonyms. 

The programs will ask "Delete user account?". If an account that currently has 
shared access to this file is to be denied access then enter the account name and 
the question will be asked again for additional accounts. When no account name is 
entered in response to this question the program will return control to the CSI. 
It is not necessary to delete shared access to synonyms of an account that is 
having its shared access deleted. This is done automatically by the method that 
the system uses for synonym accounts. 

Example 

>SHARE MYFILE.DATA;A 

Add user account? ALPHA 
Add user account? OMEGA 
Add user account? 
Delete user account? BETA 
Delete user account? 
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SHOW cQwmm 

The SHOW command provides you with the ability to display the status of certain 
system parameters. The format of the SHOW command is: 

SHOW <fimctioxi> 

SHOP Ftiactioias ■ 

The various functions available with the SHOW command include the following, 
y ABB REV Display the status of the abbreviation switch. 
^ CANCEL Display the currently defined console keyboard line~cancel character. 

CLKFRQ Display the current clock frequency adjustment constants* 

CLO CK Display the system clock continuously. To exit from this mode you must 
use the system cancel-key. 

Note: Your system may not support the time of day feature. 
"^ BATE Display the current system time and date. 



J 



DATEFOHM Display the current date format 



^ DISK Display the status of all attached disks, or, when followed by a disk 
specification, the status of the specific disk. 

M DOW, Display the currently defined console keyboard down-arrow character. 

■"' ERRHUM Display the status of the error number switch. 

^ cRSTEXT Display the status of the error text switch. 

^ ESCAPE Display the currently defined console keyboard escape character* 

V HISTORY Dispay the status of the history switch. 

•^ 7M?EXEC Display the status of the implied EXEC switch. 

"^ LEFT Display the currently defined console keyboard left-arrow character* 

[ vfEMQRY Display the the current allocation and usage of memory. The information | 

j displayed includes the partition identif icatin nui^er (Port)* activity f 

'; flag and memory bank number (Bank), partition start address (MEMLO), { 
partition end address (HEMMX), current partition high memory (MEMftI), { 

■ current partition stack pointer (SP), current partition execution address | 

I (PC), partition size, in decimal (Size), command name being executed by | 

I partition (Routine), user name logged onto partition (Username) • \ 

', The activity flag under the Bank column will have one of five available { 

I values: f (■ 

!■■ ■ 

/ blank Partition is active and executing a program. 
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I 1 Partition is waiting for a shared resource. 

{ 2 Partition is waiting for an interrupt- 

1 4 Partition is waiting for the disk. i 

I 8 Partition has not been started. 

^ PRIVLEV Display your current maximum privilege level. 
V RDYMSG Display the status of the ready message switch. 

V RIGHT Display the currently defined console keyboard right-arrow character. 

V RTCA VAIL Display the status of the real time clock available switch. 

V RUBO UT Display the currently defined console keyboard rubout character. 

V SER IAL Display the serial number of the operating system. 
I SLICE Display the current system time slice value. 

V SYNONYM Display the synonyms currently defined. Any system defined abbreviations 
will be displayed first followed by all of the user defined synonyms and 
abbreviations. 

^ TIME Display current system time and date. 

Note: Your system may not support the time of day feature. 

^P Display the currently defined console keyboard up-arrow character. 

I Display the users that are currently logged onto the system. The information 
j displayed includes the partition numberr, account name, and logon date and time. 

^uf^t LSION -Display the version number, version date, and the privilege value of all command 
'^ programs on the specified disk. When no disk is specified the S disk is assumed. 

^^llji^__ Display the account name of the account that you are currently logged onto. 

:^ Display the current time and date, the memory size of your partition, and the 
^ status of: ABBREV, RDYMSG , IMPEXEC , ERRNUM, ERRTEXT, HISTORY, VERSION, ESCAPE^ UP, 

DOWN, LEFT, RIGHT, RUBOUT, CANCEL, SYNONYM, SLICE, PRIVLEV, MSG, SERIAL, DATEFORl-I, 

and CLKFRQ. 

Note: Your system m^iy not support the time of day feature. 
SHOW Essu^les 

The following examples illustrate the uses of the SHOW command. 

>SHOW RDYMSG 
RDYMSG = OFF 

>SHOW ABBREV 
ABBREV - ON 
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>SHOW IMPEX 
IHPEXEC = ON 

>SHOW DISK S 

S(l) Label; "SYSTEM ",WP, 

Backup onto "SYSTEM$B" on 08/09/78 13:12, 

Capacity: 308K bytes, (77-1-16) , 

Available: 142K bytes (46%), 

Largest area: 140K bytes, 

48 files is use (out of 112). 

The information displayed by the SHOW DISK function is: 

Line-1 Directory label; drive number; disk label; write protect status. 

Line-2 Backup disk label; backup date and time. 

Line~3 Disk capacity; number of cylinders; number of heads; number of sectors per 
track. 

Line-4 Amount of storage available; percent available. 

Llne-f* Largest amount of contiguous storage available. 

Iilne~6 Number of files in directory; total number of directory entries allocated. 
This is a reflection of all files on the disk, not just the files 
accessible from the current account. 

The SHOW DISK function, in addition to displaying the above information, 

:l1so validates the allocation of the disk. If any misallocation is 

-.etected an error message is displayed. Negative misallocation indicates 

hat more space has been allocated for file storage than is actually in 

--.se. Positive misallocation indicates that less space has been allocated 

*:han is actually in use. These are dangerous conditions - the disk should 
^ot be used until the misallocation is corrected. The positive 

raisallocation indicated that at least two files are sharing the same disk 
pace. Any misallocation may be corrected by copying all of the files to a 
>lank disk,, one file at a time. If positive misallocation existed then one 

ox more files may contain invalid data. 

'~.e following version numbers and dates do not necessarily reflect the current 
;rs ion number for the system programs. 



wm- - 94 ~ msMm 



CHAPTER 34: snm CKmmm 



>SHOW VERSION 



Module 


Version 


Date 


Priv 


ACCOUNT 


5.4 


18FEB80 


5 


ASSIGN 


5.4 


04 JAN 80 





ATTACH 


5.4 


04JAN80 





BACKUP 


5.4 


04JAN80 


3 


BASIC 


5.4B 


06JAN80 


2 


CHANGE 


5.4 


21JAN80 


3 


COPYFILE 


5.4 


I9FEB80 


1 


CREATE 


5.4 


05FEB80 


1 


DEBUG 


5.4 


26DEC79 


4 


DUMPDISK 


5.4 


04JAN80 


2 



>SH0W SYNONYM 

System User Shortest 
Command Synonym Form 



ASSIGN 


ASS 


ATTACH 


AT 


BACKUP 


BAC 


COPYFILE 


C 


CREATE 


CR 


DUMPDISK 


DU 


EDIT 


E 


ERASE 


ER 


EXEC 


EX 
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>SHOW * 

SHOW ver 5.4 22MAR80 

11:16:20 Monday, March 31, 1980 

NAME = SYSTEM 

ABBREV = ON 

RDYMSG = OFF 

IMPEXEC = ON 

ERRNUM = OFF 

ERRTEXT = ON 

HISTORY = ON 

VERSION = ON 
I MSG = ON I 

ESCAPE =27 

UP = 26 

DOWN = 10 

LEFT =8 

RIGHT - 6 

RUBOUT == 127 

CANCEL = 24 

SYNONYM = (STD) 
I SLICE = 100 I, 

PRIVLEV = 5 

SERIAL = 3-1 

CLKFRQ = 10,100 

I >SHOW MEMORY { 

1 . I 

1 Port Bank MEMLO MEMMX MEMHI SP PC- Size Routine Username f 

1 OOOOH A886H 19712 NUCLEUS 

I 1* A580H FDFFH FB21H FAF3H A580H 22656 SHOW SYSTEM 

1 2 2 4D00H A57FH A2A2H A27AH A2C8H 22656 CSI DEMO 

j >SH0W MEMORY f 

y t 

I Port Bank MEMLO MEMMX MEMHI SP PC — -Size Eoutiae Username { 

I OOOOH 4CFFH 19712 NUCLEUS I 

I ABOOH A886H 23431 BASIC I 

1 1 D087H FDFFH FB21H FAF3H D087H 11641 CSI TOM [ 

1 2* 4 A887H D0B6H CDA9H CD87H CBCFH 10240 SHOW PAYROLL I 

\ . . . ■ ■ • -■ , I 

I >SH0W USERS . I 



Port Username Log-Date Log-Time j 

1* SYSTEM 03/31/80 09:23:15 f 

2 DEMO 03/31/80 10:55:12 | 

:. PAYROLL 03/31/80 08:30:20 | 

I 



mm -^ M — msMm 



CB^£TSSi 35 

SPOOLER cmmAm 

The SPOOLER command is an optional OASIS product and may not be included in your 
system. 

The SPOOLER command allows you to control the system's print spooler. Not all 
systems that support the OASIS operating system can use the print spooler, only 
those systems that have hardware interrupt capability. An indication of hardware 
interrupt capability is the existence of the time of day clock in OASIS. The 
format of the command is : 

SPOOLER <function> 

Where function is one of the following: 



STATUS 



IN IT Indicates that the system print spooler is to be loaded and initialized. 
In order for the print spooler to be initialized the PRINTERl device must 
be already attached and the file SYSTEM. SP00L$$1 must exist, on-line. 
When the spooler is initialized and not suspended (see below) all output 
directed to the PRINTERl device will go through the print spooler. 

Indicates that the current status of the print spooler is to be reported. 
One of several messages may be displayed, including: 

Spooler is not initialized. 
Spooler is busy printing. 
Spooler is waiting for work. 
Spooler is waiting for printer. 
Spooler is suspended. 

SUSPEND Indicates that the system print spooler is to be suspended, after the 
current report being printed by the spooler is finished. Once the spooler 
has been suspended all further output directed to the PRINTERl device will 
output immediately to that device- The spooler remains in memory. 



RESUME Indicates that the system print spooler is to resume its function. This 
function is only effective when the spooler is currently suspended. When 
the spooler is resumed, any reports previously suspended will start to 
print. 

ABORT Indicates that the current report being printed by the spooler is to be 
aborted. The message "Aborted" will be printed on the PRINTERl device 
when this is done, whether or not there was a report actually aborted. 

The OASIS system print spooler is a queing logical device. Once the spooler has 
been initialized and is not currently suspended, all output directed to the 
physical device that PRINTERl is attached to will be "spooled". This means that if 
PRINTERl is attached to SIOl and if COMMI is attached to SIOl all output directed 
to PRINTERl, COMMI, or SIOl will be spooled. For this reason it is best to have no 
other logical devices attached to the physical device that PRINTERl is attached to. 

The print spooler can only be "un-initialized" by re-booting the system. 

Do not use the print spooler for reports that require operator attention during the 
printing process as the spooler is a "background" task that can only be interrupted 
between reports, not in the middle of a report. This specifically excludes reports 
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that require a form alignment pattern to be generated, reports that print on 
non-continuous paper (must pause between pages), etc* 

As stated previously, not all OASIS systems have a print spooler. Even if your 
system does have the print spooler it may be ill-advised to use it. In general, 
only use the print spooler in systems whose disk access is considerably faster than 
the printer being used. This means that if you have a slow disk or a fast printer 
it will be inefficient to use the spooler. 

Some situations do arise where the spooler can be convenient ,. even though 
technically inefficient such as: listing several files followed by editing. Since 
the edit process does not use the disk (after the program and file are loaded into 
memory) the disk and printer are idle during the editing process. If the file 
listings are directed to the print spooler first then the editing can be done 
simultaneous to the spooler's output of the file listings. 
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STA&T COMMAHD 

' The START command is only available on multi-user OASIS. 

The START command activates a user partition. The format of the command is: 

I 

I STA&T <pi3a> [(<indev> [<outdev> [<device optioaB>] ] [ ) ] 3 

1 

I or 

I 

I START <comaaand> 

I 

{-.-^ Where: 

I 

I <pin> Indicates the partition identification number of the user partition to be 

j started. This partition must have been previously defined by a SET MEMORY 

I command. 

I 

i When no parameters are specified after the <pin> then the partition will 

I be activated with the console ATTACHed to SIO<pin> and the ATTACH options 

I will be the same as the console of the partition performing the START. 

1 

( <indev> Indicates the physical device name to be used as the CONIN device for the 

[ user. 

r . 

I <outdev> Indicates the physical device name to be used as the CONOUT device for the 

I user. This specification may be omitted which will indicate that the 

I CONOUT device is the same as the CONIN device. 

[ ■ ■ ■ ■ 

<device options> Indicates the options to be used on the console device. All of 

, the options listed in the ATTACH command description may be used, if 

I applicable. 

J ■ .. 

I command Indicates that the command is to be performed as a phantom job. In this 

j situation the START command searches for an allocated but inactive 

I partition to be used as a phantom user. When one is found the specified 

I command is executed in that parition. The phantom user, when started in 

I this manner, only has access to the public disks; no console is available. 

!■■ ■ 

j When the phantom user is started in this manner the partition will be 

I assigned to the phantom user name BK#nn where nn is the number of the 

I phantom user (not its partition number). The task specified by <command> 

( will be executed and after the task is completed, the parition will become 

j inactive again. In order to have the phantom user perform more than one 

[ task the command that you instruct it to execute should be an EXEC. 

I 

I While a phantom user is executing you may monitor its progress by using 

I the PEEK command- 

i ■ 

j When the START command is executed the user on that partition is asked to logons 

I If the user does not have the console turned on yet he may enter a carriage return 

I after turning his console on and the logon message will be re~displayed- 
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START Exaii!|»le: [ 

Multi-user OASIS version v.r 64K [ 

Time (HH:1#I:SS) 815 y 

Date (MM/DD/YY) 1030 ] 

I 

08:15:00 Monday, October 30, 1979 t 



Logon Please: IPL 



> 
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>SET MEMORY 2 10240 j 

■■ J- 
>START 2 (SI02 B9600 L63 P15 FF6 C4 | 

t 

>SET MEMORY 3 18000 [ 

>START BASIC TESTPROG j 



I 
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STATE C(MMA3a> 

The STATE command provides a quick means of determining the existence of a file or 
group of files. The format of the STATE command is: 

STATE <file-desc> [<optic«i>. . • ] 

Where: 

<file-desc> Indicates the description of the file or files to be "stated". 
Wildcards are acceptable. 

STATE Options 

TYPE Indicates that the number of files found and their total allocation is to 
be displayed on the console. This is the default option. 

NOTT YPE Indicates that nothing is to be displayed. This option is useful when the 
STATE command is executed from an EXEC and it is necessary to know whether 
a file exists or not. A return code of indicates that the file does 
exist and a return code of 12 indicates that the file does not exist. 

PUBLIC Indicates that the public files (owned by the system) are to be included 
in the search. 

When the STATE command is executed one of two messages will be displayed. If no 
file can be found that matches the file-desc the message "No files lound" will be 
displayed and the system return code will be set to 12. If one or more files can 
be found that match the file-desc then the message "nn files, nnn blocks" will be 
displayed. The nnn blocks indicates the number of blocks of disk storage used by 
the files qualifying. (Return code set to OO 

The STATE command operates only on files accessible to the current account. When 
wildcards are used the public account files will be included in the file count and 
number of blocks of storage used. When the file description is explicit the public 
account files will only be included if a match cannot be found in the private and 
shared files. This means that an explicit file description of a file that is both 
in the private or shared account and also is a file in the public account will 
result in only the private or shared file being reported. 

STATS Eacaaples: 

>STATE * COMMAND S 

42 file(s), 219 block(s). 

>STATE * BACKUP S 
No files found. 
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STOP cKmsmo 

The STOP command is only available on multi-user OASIS. 

The STOP command deactivates a user partition. The format of the command is: 

STOP <pini> 

Where: 

<pin> Indicates the partition identification number of the user partition to be 
deactivated. 

The STOP command can only be used on a partition that has logged off (see LOGOFF 
command) . 

The STOP command does not release the memory used by the partition—the SET MEMORY 
command does that . 
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SYSGEH cmasmo 

The SYSGEN command allows you to save the status of certain system parameters for 
future initial systepi loads. The format of the command is: 

The specific parameters that the SYSGEN command saves include all ATTACHments of 
logical to physical devices along with their options, and the status of the 
following SETable switches: 



ABBREV 

CLKFRQ 

DATEFORM 

ERRNUM 

ERRTEXT 

HISTORY 

IMPEXEC 

PRIVLEV 

RDYMSG 

SLICE 

SYNONYM 

VERSION 



Single user version only 



Multi-user OASIS 
value. 



SYSGEN will save the SLICE value but will not save the PRIVLEV | 



I In multi-user OASIS the data saved by the SYSGEN command only applies to the [ 

I partition 1 user; however, some of the data saved is global in nature and therefore | 

is saved for all users: CLKFRQ, DATE, ERRNUM, ERRTEXT, HISTORY, SLICE, and TIME» | 
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CHAPTER 40 

TEXTEDIT COMMyySB 

The OASIS TEXTEDIT command allows you to create and maintain files for use by 
programs such as the EXEC language processor, the BASIC compiler /interpreter, the 

MACRO assembler, the SCRIPT processor, etc. Although the Editor is generally used 
to create or maintain files for these processors there is no restriction on its 
use: you can maintain files to be used by your own programs. 

A file that is created or maintained by the TEXTEDIT program for use by another 
system program generally contains a mixture of commands and data to that program. 
These commands or data should not be confused with the commands that the TEXTEDIT 
program uses. For example, the operator may wish to create a file of commands and 
data to be used by the EXEC processor. All of these commands and data are treated 
as text to the TEXTEDIT program. 

The OASIS TEXTEDIT command is a file editor with commands that allow you to change, 
add or delete text from a file. All of these commands are oriented to the user, 
that is, these commands are English words whose meanings indicate the function that 
they perform in the Editor. For instance, the command that indicates that you wish 
to locate the next occurence of a sequence of characters is "LOCATE". 

All of the commands may be abbreviated to the first character except the FILE and 
QUIT commands which might cause unrecoverable results. 

The OASIS TEXTEDIT is a line oriented editor. This means that after a commatid is 
executed the text pointer is positioned at the beginning of the current line and 
the commands reference entire lines. For instance the "DELETE" command deletes 
lines of text; the "INPUT" command inputs lines of text; the "PAGE" command types 
lines of text; etc There is a command available that allows you to use this 
editor as a character oriented editor. This is the MODIFY command. 

Caution: Do not allow a CTRL/Z character to be placed in a file. Tliis character is 
interpreted by most programs as meaning the end-of-file and will probably cause 
loss of data if placed in a file by an operator or user program. 

40.1 IxKVokisg the OASIS TSSSHSDTWWi 

To enter and use the OASIS text editor you use the CSi TEXTEDIT command in the 
following format: 

tSSSSBlT <filc-desc> 

When this command is executed the TEXTEDIT program is first loaded into memory and 
the file description is passed to the program. The program then searches the 
directory (specified or default search sequence) and, when the file is found, reads 
the entire file into memory. If the entiire file cannot fit into memory due to the 

amount of memory available the Edit program will display the message: "Available 
Memory Now Full:" followed by the last line of text that it was able to read. If 
this line of text is not the last line of text in the file then the operator should 

abort the edit session and reduce the size of the file by manipulating it with the 
COPYFILE command. 

If memory is filled up when the file is read in, and the last line of text is the 
line that is displayed after the error message, the operator may continue the edit 
session if he first deletes some of the text lines before adding any new text. 
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When the file is not found on the specified directory or the default search 
directories then the edit program will display the message "New File" before 
displaying the prompt character. 

Due to the fact that the disk image of a file being edited is not updated until the 
operator FILEs the memory image of the file the System Cancel command is redefined 
in the edit session. If this key were not redefined then it is possible that hours 
of work may be lost by the Inadvertant typing of this command. To abort an edit 
session the operator uses the QUIT command. 

TEXTEDIT Frompting Character 

After the TEXTEDIT command has been executed an asterisk (*) will be displayed on 
the left side of the console terminal. This is the prompting character for the 
TEXTEDIT program and indicates that the TEXTEDIT program is waiting for a coimaand. 

TEITEDI1! Modes 

The OASIS TEXTEDIT has two modes of operation: the command mode, which is indicated 
by the edit prompting character on the left side of the screen, and the text input 
mode, which is indicated by no prompting character on the left side Of the screen. 

•lEISSDIT €©iaiia»ds. General 

Most of the edit comm^ands have parameters following the command word. These 
parameters tell the edit conanand interpreter what the operator wishes to do 
specifically. 

Parameters to the edit commands may be of two types: numeric and string. Numeric 
parameters are always assumed to be decimal (base 10); string parameters are always 
enclosed within delimiters. A delimiter is a character that indicates the 
beginning or end of something. For more versatility the OASIS editor allows many 
characters to be string delimiters. The only restriction being that the delimiting 
character may not be a space character or a question mark character, and the 
delimiter may not be part of the string. The terminating delimiter, when used, 
ziuBt he the same as the beginning delimiter. For documentation purposes the slash 
character (/) will be used for the string delimiter. 

li, while typing a line of text or conmiand, the operator should wish to cancel what 
lie, has entered, he may type either the program cancel-key or the line cancel-key. 
*?his will abort the line being typed with no change to the text file. 

Ci«2 Bottom Coiwo nd 

r.ie BOTTOM command allows the operator to position the pointer to the end of the 
;axt. The format; of the BOTTOM command is: 

> lie BOTTOM command will position the pointer to the line before the end of file 
uaricerj, and display the line* If there are no lines of text in the file then the 
OTTOM command will display TOF: indicating that the line before the end of file 
saarker is the top of file marker. 
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40.3 Case CoscDsaand 

The CASE command instructs the editor on whether to 'fold' the input from the 
keyboard to uppercase, lowercase or to accept the input as is. 

The format of the CASE command is: 

CASE [mode] 

Where: 

Mode Meaning 

U 'Fold' or change all alphabetic input from the keyboard to upper 
case. This is the default CASE mode. 

M Accept all input from the keyboard with no translation of case mode. 
This is the default case mode for all non-program file types. 

L Accept all input from the keyboard with inverse translation. This is 
the inverse of the CASE mode M. All alphabetic characters typed from 
the keyboard as text input are translated to their inverse case 
before display. This feature is useful when the console keyboard 
does not have a shift lock key. 

40*4 The Carriage Return Cosmand 

The carriage return command is provided as a quick and easy means of advancing the 
text pointer to the next line of text in the file. It is identical in effect to 
the DOWN 1 command. The format of the carriage return command is simply to enter a 
carriage return after the edit prompt character. 

40-5 Delete Comsaaaad 

The DELETE command allows the operator to delete whole lines of text from the file. 
The format of the DELETE command is: 

DEL ETE [<niin>l 

Where: 

<nnn> Indicates the number of lines to be deleted, including the current 
line. , 

<blank> When no parameter is specified after the command DELETE then only the 
current line is deleted. 

40«6 Down Cofmemd 

The DOWN command allows the operator to position the pointer down to the next line. 
The format of the command is: 

■ mmt 

When the DOWN command is executed the next line in the text file becomes the 
current line and is displayed on the console. 

SYSRSF - 1G7 ~ TESI^BIir 



SYSTEM EEFSESHCE HAMOAL 

40»7 Down Arrcm Command 

The down arrow command provides a quick and easy means of specifying that the text 
pointer is to advance one line of text. When the operator types the down arrow key 
the editor will interpret it as the DOWN command, display the message DOWN, and 
advance the text pointer one line of text. Some terminals label the down arrow key 
as "line feed" or "LF". 

40.8 File Coi^aand 

The FILE command allows the user to terminate an TEXTEDIT session normally by 
updating the file and returning to the CSI. The format of the FILE command is: 

FILE [<file-aesc>3 

Where: 

<file~desc> Indicates an optional file description. When the <file~desc> is 
specified, only as much as is necessary need be entered, the omitted 
parameters v/ill default to the current file description. 

When <file"-desc> is specified the current file description is not 
changed but the <file-desc> specified is the description used by the 
FILE command. 

r/hen no <f ile~desc> is specified after the FILE command the current file 
Jescription is used. In either case when the FILE command is executed the editor 
pyrites the file in memory to the disk file. If the editor finds an existing file 
on the specified disk with the same name and type as that being filed, the file 

/pe of that file is renamed to BACKUP, erasing any other file by that same 
Jescription. When the editor has successfully "filed" the text file the file 

es crip t ion that it was saved as is displayed on the console terminal along with 

he message "filed". Control returns to the CSI. 

';0»9 Iiaput (kmrnrnkd 

'vhe INPUT command allows the user to add new text to the file- The format of the 
:!?PUT command is: 

JPF0T 

Alve INPUT command allows multiple lines of text to be added with each line added 
^:ter the current line. As each line is added it becomes the the current line- 

>.hen the editor is accepting multiple lines of text no prompting character is 
•.,.^Dlayed on the left side of the console. This is because the pron^ting character 
" uicates that the editor is ready to accept a command and in this case it is not 
cceo ting commands but text. 

./j return to the edit command mode the user merely types a carriage return with no 

^xt T3recading it. 

-.'i!&»lB Locate Coieaiaiid 

She LOCATE command allows the user the ability to locate and position to the next 
occurrence of a sequence of characters. The format of the LOCATE command is: 

.a^3r®iT ■ «.. 1©8 ~ . SSSSSM 
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LOCATE [/<string>£/3] 



Where; 



<string> indicates the sequence of characters that the editor is to search 
for. The search begins with the line following the current line. If 
the sequence of characters is found then the text pointer is 
positioned to the line that contains that string, and the line is 
displayed. If the sequence of characters is not found then the 
editor displays the message: "Not Found:" followed by the command 
that is was trying to execute. The text pointer is not chatiged when 
the string is not found. 

<blank> Indicates that the last valid LOCATE command is to be executed again. 

40. II Modify Coaoaand 

The MODIFY command is the only command that allows the editor to act like a 
character oriented text editor, and when the MODIFY command is being executed there 
is a new set of commands available to the user. The format of the MODIFY command 
is: 

MCeOIFY I<nnn>|*3 

Where: 

<nnn> Indicates the number of lines that are to be modified. 

* Indicates that all lines starting with the current line to the end of 
the text file are to be modified. To exit from this mode before the 
end of the file is reached you must use the Program Cancel-key. 

<blank> When no parameter is specified then the default value of one is used 
indicating that the current line is to be modified. 

When the MODIFY command is executed the line to be modified is displayed on the 
console terminal and the cursor is positioned at the first character position. The 
editor is now in a character oriented mode and the MODIFY command makes full use of 
the fact that the console terminal is normally a CRT with cursor positioning 
controls. The cursor indicates the current text pointer position in the line. Any 
changes made to the line are immediately indicated by the display of the line and 
the position of the cursor. 

Any control characters imbedded in the line are expanded for display purposes to 
two characters: an up arrow character C*^) followed by the ASCII representation of 
the control character. For example, a CTRL/I is displayed ''I. Even though the 
control character is displayed as two characters it actually is only one character. 
When a control character is deleted from the line both characters are erased from 
the display. When a control character is skipped over, both charaGters are 
skipped, etc. 

The commands available to you when the editor is modifying a line are one character 
commands, but still the one character is the first character of the word that it is 
an abbreviation for- When possible, it is the same character that would be used in 
the edit command mode. 
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The following sub-sections discuss the commands available from the MODIFY command. 
When you type a command it is not displayed as that would disrupt the display of 
the line being modified. Any effect that a conimand has on the text in the line is 
immediatly displayed however. 

Insert Characters SubconBtaad (I) 

To insert new characters into the line the user types the insert coomiand (I). Any 
characters typed after the I has been typed are added to the line before the 
current character. As each character is added to the line the remainder of the 
line is re-displayed. 

To exit from the Insert character command you type a carriage return. 

While in the insert character command you may backup one character position by 
typing the RUBOUT key. This backs the text pointer up one position, the cursor is 
backspaced, and that character is deleted. It is possible to backspace past the 
position that the insert command was given. 

Pelete Character SubcoBaaand (D) 

To delete a character from the line you use the delete character command (D). 
Every time a D is typed the current character is deleted from the line and the 
character is erased from the screen. This is an immediate command. 

Re|>lace Characters SubcdaeeBand (BL) 

To replace characters in the line you use the replace character command (R) . After 
the R command has been typed each character that is typed replaces the current 
character and the text pointer is advanced one character position. 

To exit from the replace character command you type a carriage return. 

While in the replace character command, you may backup a character position by 
typing the RUBOUT key. This will back the text pointer up one position and the 
cursor will backspace. No characters are deleted and the editor is still in the 
waplace character command. It is possible to backspace past the position that the 
^aplace character command was typed and still remain in the replace character mode. 

Advance Character Subcoisraaad ( ) 

To advance the cursor and text pointer one position you type the advance character 

command ( ), a space. When the space is typed the text pointer and the cursor are 

•advanced one character position. You may not advance past the end of the line, 

I Dwever you may insert new characters at the end of the line or replace characters 
. : the end of the line. 

Jhe right arrow has the same effect as the space key and is more graphic in its 
leaning. Both may be used interchangeably. 

Find Oiaracter Subcommand (F) 

To advance the cursor and text pointer to the next occurrence of a specific 
character you use the find character command (F) followed by the character to be 
positioned to. When the F is typed followed by another character the cursor is 
advanced to the next occurrence of that character in the line being modified. The 
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character specified must be entered in the same case as the character to be found. 
When the character can not be found the cursor will be positioned to the end of the 
line. 

Backspace Character Subcoaoniand (RUB) 

To back the text pointer and cursor one character position you type the backspace 
character command. This command is any of the keys defined as the character delete 
keys, such as left-arrow, CTRL/H or RUB. The left arrow is more graphic in its 
meaning and is usually the key that is used for the RUBOUT. When this key is typed 
the text pointer and the cursor are backed up one character position. 

Uppercase Character SubcoxraDaxid (U) 

To change the current character to uppercase you type the uppercase character 
command (U). When the U character is typed the current character is translated 
into uppercase, redisplayed and the text pointer and cursor are advanced one 
character position. 

Lowercase Character Subcosijaand (L) 

To change the current character to lowercase you type the lowercase character 
command (L). When the L is typed the current character is translated to lowercase, 
redisplayed and the text pointer and cursor are advanced one character position- 

Begliinliog of Line Subcomeiaiid (B) 

To position the cursor and text pointer to the beginning of the line being modified 
you use the beginning of line command (B)« When the B is typed the cursor is 
positioned to the first character in the line. 

End of Line Subcoaraand (£) 

To advance the cursor and text pointer to the end of the line you type the end end 
of line command (E) . When the E is typed the cursor and text pointer are advanced 
to the end of the line. 

This command allows the user to easily add or change text at the end of the line. 

Quit SiibcoKBtaiid (Q) 

To quit the modification of the line and restore any changes made to the line you 
type the quit modify command (Q). When the Q is typed the line is re -displayed as 
it was before any changes were made and the modification of the line is terminated* 
If there are any iterations of the MODIFY command remaining then the text pointer 
advances one line and the next line Is placed in the MODIFY mode. 

End Hodlf 7 Sabcoanaiid (SET) 

To end the modification of the line and save any changes made to the line you type 
the end modify command (carriage return) . When the carriage return is typed the 
line is re-displayed with all changes saved and the modification of the line is 
terminated. If there are any iterations of the MODIFY command remaining then the 
text pointer advances one line and the next line is placed in the MODIFY mode. 
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40»12 Page CoimaawLd 

The PAGE command allows the user to display a page of text and to position the text 
pointer to the end of the next page of text. The format of the PAGE command Is: 

PAGE 

The PAGE command will display one screen of text. 

The first line of text displayed by the PAGE command is the current line. The last 
line of text displayed on the screen by the PAGE command is determined by the class 
of terminal designated by the OASIS ATTACH command. For the CRT this would be 15 
lines of text. At the end of the execution of the PAGE command the text pointer 
will be positioned to the beginning of the last line displayed. This means that if 
two PAGE commands are typed consecutively then the first line displayed by the 
second PAGE command is the last line displayed by the first PAGE command. In this 
manner it is easy to observe the flow of text in spite of the page break. 

40.13 Quit Cdfisaand 

The QUIT command allows the user to abort an edit session without updating the file 
on the disk. This may be necessary for many reasons such as specifying the wrong 
file in the TEXTEDIT command or the operator has decided that the changes made to 
the file should not be saved. The format of the QUIT command is: 

^glT [<retiiria code>3 

tJhen the QUIT comsiand is executed with no return code following, the editor will 
set the return code to zero and return control to the environment that invoked the 
TEXTEDIT command (CSI or EXEC) without updating the file. When the return code is 
specified it must be a numeric value between and 255. The value is assigned to 
the system return code and control is returned to the environment that invoked the 
TEXTEDIT command. 

40»14 Top Commmd 

The TOP command allows the operator to position the text pointer to the beginning 
of the text file. It has the inverse effect of the BOTTOM command. The format of 
the TOP command is: 



Upon execution of the TOP command the text pointer will be positioned to the top of 
file marker which is before the first line of text» The editor will display the 
tpessage: "TOF:". This command is the only command that will allow the operator to 
enter lines of text before the first line of text- Refer to the INPUT command- 

^:»15 Vp €kmmamd 

The UP coxBDiand allows the operator to position the text pointer backward in the 
text file. The effect of the UP command is the reverse of the DOWN command. The 
format of the UP comtoand is: 

we [<iiim>3 
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<nnn> Indicates that the editor is to position up nnn lines from the 
current text pointer* If the value of nnn is greater than the number 
of lines that precede the current line then the text pointer will be 
postioned to the top of file marker and the message: "TOF:" will be 
displayed. 

<blank> When no parameter is entered after the UP command then the last UP 
/string/ command is used. If there have been no prior UP /string/ 
commands executed then UP 1 is used. 

40*16 Up Arrow Coonaxkd 

The up arrow command allows the user a quick and easy means of specifying that the 
text pointer is to back up one line of text. When the operator types the up arrow 
key the editor will interpret it as an UP 1 command, display the message UP 1, and 
back the text pointer up one line of text. If the console terminal does not have 
an up arrow key then the user may use the CTRL/Z key instead. 
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40»1? TEITKDIT Commsid Summary 

BOTTOM Locate end of file. 

CASE Set upper, lower, or mixed. 

DELETE Reraove lines of text. 

DOIvlJ Advance line pointer. 

FILE Save text file on disk and return to system. 

INPUT Accept text from keyboard. 

LOCATE Locate specified string in text. 

MODIFY Allow character-by-character change of current line- 

B Position to the beginning of the line. 

D Delete one character. 

E Advance to end of line. 

F Find and position to specific character. 

I Insert characters. 

L Convert to lower case. 

Q Quit modification - no changes made. 

R Replace characters. 

U Convert to upper case. 

<sp> Advance one character. 

<DEL> Backup one character. 
PAGE Display one screen of text on console. 
QUIT Abort this edit session. 
TOP Locate top of file. 

UP Position line pointer backwards in file. 
<CR> Advance line pointer one line. 
<np-arrow> Position line pointer up one line. 
<down-arrow> Position line pointer down one line. 
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40.18 TEXTEDIT Errors and Messages 

Message Explanation 

Not Sequential Error message - occurs when an attempt is made to TEXTEDIT an 
indexed or direct file. 

Invalid command syntax Error message - occurs during edit command mode. This error 
message Indicates that the operator has typed a valid command name but has 
used the wrong parameters or has made a typing error. 

Unrecognized comsaand: Error message - occurs during edit command mode. This error 
is usually caused by the operator typing text when the editor is expecting 
a command. Also occurs when a command abbreviation is used and not 
separated by a space from text that follows it. 

Too many paraimteters : Error message - occurs during edit command mode. 

Invalid nnaaerlc Error message - occurs when the command syntax requires a numeric 
parameter but the operator has entered a alpha character. 

Space required following coiEaaiand Error message - 

Required parasneter lalsslng: Error message - occurs when the operator has not 
entered all of the parameters required by the command syntax. 

Must be U, L, or M Error message -- occurs during CASE command and operator has not 
specified a valid CASE mode. 

Invalid fllenane Error message - occurs when operator has specified a file 
description. File names must start with an alphabetic character, contain 
only alphbetic, numeric or the $ character and can be no more than eight 
characters in length. 

fn.ft:fd filed Information message - displayed after the editor has successfully 
FILED the text file. 

File Haae Missing Error message - occurs when operator has specified a file 

description with a missing name field- 
File Type Missing Error message -■ occurs when the operator has specified a file 

description with a missing type field. 

NEI7 FILS: Information message ~ displayed when the TEXTEDIT program is first 
entered and the specified file to be edited is not found. 

EDIT: Information message - occurs when the editor re-enters the edit command 
mode after the INPUT command is exited- 

IHFUT: Information message -• displayed when the editor enters a multlpla Life 
input or replace mode- 

EGF: Information message - displayed when the editor encounters the end of file 
marker. 
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TOFi Information message ~ displayed when the editor encounters the top of file 

marker- 
Hot Foimd: Information message - displayed when the editor can not LOCATE the 

sequence of characters specified. 

No Eoom: Error message -occurs when the editor detects that there is insufficient 
memory available to save the line of text just entered by the operator. 

End of M^aaory Eisaclied: Information message - occurs when the editor detects that 
there is probably insufficient memory available to add more lilies of text. 

DOUP Information message - displayed in response to the operator typing the 
down arrow in the command mode. 

IFF Information message ~ displayed in response to the operator typing the up 
arrow in the command mode. 

Available Mesaory Host Full: Information message - occurs during input of text or 
when TEXTEDIT is loading the file into memory. Indicates that the text 
was accepted and saved in memory but there is not sufficient space 
available for any more text input. 

The operator should delete some text to make space available or divide the 
file into multiple files (if the purpose of the file will allow multiple 
Mies.) . 

^ioisieated: Error message - the operator has INPUTed, CHANGEda or MODified a line 
whose new length is greater than 255. The line has been truncated to 255 
characters and is displayed following the error message. 

3ACMSW File Is Protected Error message - Indicates that the editor cannot rename 
the input file to BACKUP because a BACKUP file already exists and it is 
delete protected. 

Casi't sa\^ a BACSHF File Error message - An attempt was made to file or save a file 
with file type BACKUP. 

3is^ Full Error message - During an atten^t to SAVE or FILE the file being edited 

the disk became full. When this occurs the input file has already been 

renamed to file type BACKUP. Use the CSI command to erase some of the 

unused files on the disk or file it with a diffemt name designating that 

a different disk drive is to be used. 
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CHAPTER 41 
UHLOAD COiiMAMD 

The UNLOAD command is only available on multi-user OASIS. 

The UNLOAD command unloads a re-entrant program from memory, freeing up its memory 
space for general usage. The format of the command is: 

PMLO AD <file-desc> 

Where: 

<program-name> Is the name of the re-entrant program to be unloaded from memory. 

The UNLOAD command may only be used in single-user mode (only one partition 
defined) . 

To make the memory used by the re-entrant program available when more than one 
re-entrant program is loaded the programs should be UNLOADed in the reverse 
sequence that they were loaded in; otherwise the memory used by a program may not 
be returned to the system. 
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APPENDIX A 
CSI COMMAHD StJMMARY 
Coiamand Function 

ACCOUNT Maintain the user account names file. _ 

ASSIGN Assign files or devices to I/O channels. 

ATTACH Make a disk or device available to OASIS. 

BACKUP Copy the entire contents of an OASIS disk to another disk. 

BASIC (Optional) Execute or maintain an OASIS BASIC language program. 

CHANGE Change the privilege value of a program. 

COPYFILE Copy a file (or portion of a file) to another file (append, replace, 

translate, etc) 
CREATE Create a new direct or indexed sequential file. 

DEBUG (Optional) Perform dynamic debugging of a machine language program. 
DUMPDISK (Optional) Display the physical contents of a disk file. 
EDIT (Optional) Create or modify an ASCII sequential file. 
ERASE Delete a file or files from a disk. 
EXEC Execute an EXECutive language program. 

FILELIST Display the files and their attributes on the terminal, printer, or to a 
" disk file. 

FILT8080 (Optional) Translate Intel mnemonic assembly language source program to 

Zilog mnemonic assembly language source program. 
FORCE Force another user to execute a command. | 

GETFILE (Optional) Copy a file from a non-OASIS disk. 
INITDISK Initialize a disk format, directory, or label. 
INTELHEX (Optional) Convert INTEL hex object code to OASIS object code. 
KILL Erase a file without de-allocating the space. 
LINK (Optional) Perform translation and editing of object programs to load 

Image programs. 
LIST Display the contents of a file on the terminal or printer. 

LOAB Load a re-entrant program for subsequent usage. I 

LOGOFF Sign off of the current user account. 
LOGON Sign on to a different user account. 
MACRO (Optional) Translate a Zilog mnemonic assembly language source program to 

an object program (assemble). 
MAILBOX Retrieve information from other users. | 

MEMTEST (Optional) Perform diagnosis of memory. 
MOUNT Allow a change of disks. 

MSG Send a message to another user. j 

OWN ERCHG Change the ownership of a file to another account. 
PATCH Update disk image of assembled program file. 

PEEK Peek at another user's console output. I 

RECEIVE (Optional) Accept a file from another OASIS system. 
RECOVER (Optional) Restore lost file to it's directory. 

RELOCATE (Optional) Create a relocatable command from an absolute command. 
RENAME Change the name or type of an existing file. 
REPAIR (Optional) Detect and correct disk mis-allocation. 
RUN (Optional) Execute an OASIS BASIC compiled program. 

SCHEDULE Schedule a task for future execution. j 

SCRIPT (Optional) Process and output an OASIS SCRIPT language file. 
SECTOR (Optional) Display sector linkages of a sequential file« 
SEND (Optional) Transmit a file to another OASIS system. 
SET Change OASIS system parameters. 

SHARE Designate a ftle(s) to be accessible from other user accounts. 
SHOW Display OASIS system parameters. 
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COOLER (Optional) Change or display status of the printer spooler. 

START Start another user partition. 

SJATE Determine existence of a file(s). 

STOP Stop another user partition. 

IXSGEN Permanently save SET and ATTACH status. 

TERMINAL (Optional) Emulate terminal to foreign syste©. 

TEXTEDIT Create or modify a text file. 

UNLOAD Unload a previously loaded re-entrant command. 

VERIFY (Optional) Read an entire disk and report any errors detected. 
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APPENDIX B 

DEVICE HDMBKR ASSIGHMgarrS 

The following numbers, names, and synonyms are the only logical device designations 
that the ATTACH command recognizes . All programs and commands communicate with 
peripherals by means of these logical device designations. The actual device that 
these are associated with is normally unknown (and irrelevant) at execution time. 
Adding additional physical device drivers to a system does not increase the number 
of logical devices in the system. 

Logical Devdlce Ntm&ers 



Internal External 

Number Number Device -Name Synonym 







DUMMY 











1 


DISK-S 


S 






1 


2 


DISK-A 


A 






2 


3 


DISK-B 


B 






3 


4 


DISK-C 


C 






4 


5 


DISK-D 


D 






5 


6 


DISK-E 


E 






6 


7 


DISK-F 


F 






7 


8 


DISK-G 


G 






8 * 


9 


CONIN 


CONI 






9 * 


10 


CONOUT 


CONO 






10 


11 


READER 


RDR 






11 


12 


PUNCH 


PUN 






12 


13 


PRINTER 1 


PRINTER, PRT, PRTl 


13 


14 


PRINTER2 


PRT2 






14 


15 


PRINTER3 


PRT3 






15 


16 


PRINTER4 


PRT4 






16 


17 


COMMl 


COMM, 


COM, 


COMl 


17 


18 


C0MM2 


COM2 






18 


19 


C0MM3 


COM3 






19 


20 


C0>M4 


COM4 






20 


21 


TAPEl 


TAPE, 


TAP, 


TAPl 


21 


22 


TAPE2 


TAP 2 






22 


23 


TAPE 3 


TAP3 






23 


24 


TAPE 4 


TAP 4 






ssssssstsssssss 


==:s=s: zsss =: : 


================ 


s=:=s=s=s== 


i=:=:s:==; 


==:=:==:'=: =:s: 


* The devices CONIN and 


CONOUT 


may be treated 


as a s 


ingle 


device 


CONSOLE. 
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APPKSDIX C 

INDSXED FILES 

As explained in the description of the CREATE command indexed files recjuire a 
filesize that is dependant upon an algorithm used in accessing the file. The 
filesize entered in the CREATE command may be fflodified by the system in order to 
optimize access to that file. Table D-1 is a partial list of the filesizes used by 
the system for indexed file access. It is provided here to inform the programmer 
of the filesize that was used in creating an indexed file- Using this information 
the programmer can calculate the amount of disk space required by the file without 
actually creating it. 

Indexed file access response time is relatively constant until the file is 
approximately 70-80% full. When a file exceeds this load factor the response time 
degrades to unacceptable times. For this reason Indexed files should be 
over-allocated to insure that the response time will not degrade. 

It should be noted that, although the average response time degrades as the file 
fills, the response time for a particular record remains constant. For this 
reason, records that will be accessed more frequently than others should be added 
to the file when the file is nearly empty. 

C-1 Indexed File Access 

An indexed file is organized in two contiquous regions. The first region contains 
the record numbers of the records in the logical collating sequence. The second 
region contains the keys and records along with a forward pointer to the next 
record in the collating sequence. 

Wien a record is added to an indexed file the key is hashed to a record location in 
the file. If the location is en5>ty the key and record is written to that location. 
The file is then searched using a binary search of the first region (index area) 
looking for the record that logically precedes this record by one. After that 
record is found its forward pointer is updated to point to the record being added 
and its previous forward pointer is transferred to the record being added. After 
this is done the index area is updated with the new record number placed in its 
proper position. 

To access an indexed record randtomly the key being looked for is hashed to a record 
location in the file. The location is read and its key is con^jared with the key 
desired. If the two keys are equal the record is returned to the program 
requesting it- If the two keys are different then the key is rehased to another 
location and the comparison is done again. This procedure continues until the 
desired key is found or an ew:gty record is found. In the latter case the program 
requesting the record is infomied that the record does not exist. 

To access an indexed record sequentially the forward pointer from the most previous 
access to the file is used to read the next record in the file. If there were 
no previous accesses to the file then the first entry in the index area is used to 
point to the logically first record in the file. 
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APPENDIX C: IliJDSXED FILES 
TABLE D-1 
Indexed File Fonaat Filesizes 



3 


7 


11 


19 


23 


31 


43 


47 


59 


67 


71 


79 


83 


103 


107 


127 


131 


139 


151 


163 


167 


179 


191 


199 


211 


223 


227 


239 


251 


263 


271 


283 


307 


311 


331 


347 


359 


367 


379 


383 


419 


431 


439 


443 


463 


467 


479 


487 


491 


499 


503 


523 


547 


563 


571 


587 


599 


607 


619 


631 


643 


647 


659 


683 


691 


719 


727 


739 


743 


751 


787 


811 


823 


827 


839 


859 


863 


883 


887 


907 


911 


919 


947 


967 


971 


983 


991 


1019 


1031 


1039 


1051 



1063 1087 1091 1103 1123 1151 1163 1171 1187 1223 1231 1259 1279 

1283 1291 1303 1307 1319 1327 1367 1399 1423 1427 1439 1447 1451 

1459 1471 1483 1487 1499 1511 1523 1531 1543 1559 1567 1571 1579 

1583 1607 1619 1627 1663 1667 1699 1723 1747 1759 1783 1787 1811 

1823 1831 1847 1867 1871 1879 1907 1931 1951 1979 1987 1999 2003 

2011 2027 2039 2063 2083 2087 2099 2111 2131 2143 2179 2203 2207 

2239 2243 2251 2267 2287 2311 2339 2347 2351 2371 2383 2399 2411 

2423 2447 2459 2467 2503 2531 2539 2543 2551 2579 2591 2647 2659 

2663 2671 2683 2687 2699 2707 2711 2719 2731 2767 2791 2803 2819 

2843 2851 2879 2887 2903 2927 2939 2963 2971 2999 3011 3019 3023 

3067 3079 3083 3119 3163 3167 3187 3191 3203 3251 3259 3271 3299 

3307 3319 3323 3331 3343 3347 3359 3371 3391 3407 3463 3467 3491 

3499 3511 3527 3539 3547 3559 3571 3583 3607 3623 3631 3643 3659 

3671 3691 3719 3727 3739 3767 3779 3803 3823 3847 3851 3863 3907 

3911 3919 3923 3931 3943 3947 3967 4003 4007 4019 4027 4051 4079 

4091 4099 4111 4127 4139 4159 4211 4219 4231 4243 4259 4271 4283 

4327 4339 4363 4391 4423 4447 4451 4463 4483 4507 4519 4523 4547 

4567 4583 4591 4603 4639 4643 4651 4663 4679 4691 4703 4723 4751 

4759 4783 4787 4799 4831 4871 4903 4919 4931 4943 4951 4967 4987 

4999 5003 5011 5023 5039 5051 5059 5087 5099 5107 5119 5147 5167 

5171 5179 5227 5231 5279 5303 5323 5347 5351 5387 5399 5407 5419 

5431 5443 5471 5479 5483 5503 5507 5519 5527 5531 5563 5591 5623 

5639 5647 5651 5659 5683 5711 5743 5779 5783 5791 5807 5827 5839 

5843 5851 5867 5879 5903 5923 5927 5939 5987 6007 6011 6043 6047 

6067 6079 6091 6131 6143 6151 6163 6199 6203 6211 6247 6263 6271 

6287 6299 6311 6323 6343 6359 6367 6379 6427 6451 6491 6547 6551 

6563 6571 6599 6607 6619 6659 6679 6691 6703 6719 6763 6779 6791 

6803 6823 6827 6863 6871 6883 6899 6907 6911 6947 6959 6967 6971 

6983 6991 7019 7027 7039 7043 7079 7103 7127 7151 7159 7187 7207 

7211 7219 7243 7247 7283 7307 7331 7351 7411 7451 7459 7487 7499 

7507 7523 7547 7559 7583 7591 7603 7607 7639 7643 7687 7691 7699 
7703 7723 7727 7759 7823 7867 7879 7883 7907 7919 7927 7951 7963 

8011 8039 8059 8087 8111 8123 8147 8167 8171 8179 8191 8219 8231 

8243 8263 8287 8291 8311 8363 8387 8419 8423 8431 8443 8447 8467 

8527 8539 8543 8563 8599 8623 8627 8647 8663 8699 8707 8719 8731 
8747 8779 8783 8803 8807 8819 8831 8839 8863 8867 8887 8923 8951 
8963 8971 8999 9007 9011 9043 9059 9067 9091 9103 9127 9151 9187 

9199 9203 9227 9239 9283 9311 9319 9323 9343 9371 9391 9403 9419 

9431 9439 9463 9467 9479 9491 9511 9539 9547 9551 9587 9619 9623 
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APPEISBIX D 
MEMOaY/DISK lAYODT 



low 



high 



U 



S 

Re-entrant 

loaded 

programs 

A /\ /\ / 

\/ \/ y 

A A A / 
\/ \/ V/ 



SCR 3 



USER 3 



Dev drivers 
SCR 2 



USER 2 



Dev drivers 
SCR 1 



USER 1 



Dev drivers 



User 3 device drivers 

System Communication Region - User 2 

User 2 program area 

User 2 device drivers 

System Comiaunicat ion Region - User 1 

User 1 program area 

User 1 device drivers 
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AFPEm)IX D: MESaOXY/DISK LAYOUT 



SCR 



low 



Attach table | 

Assign table | 

SET switches j 

Partition j 

memory | 

configuration j 

Logon data | 

Synonym name j 

Tabsets J 

etc. I 

I 

A /\ A /\ I 

\/ \/ V/ \/ 



high 



/\ /\ /\ A / 
\/ \/ A/ \/! 

WORK I 256 byte work area 

PCR I 
Command string | 256 byte communication area 



OikSIS Disk Layout 



Sector 



Contents 



Boot loader- 

1 Disk label and allocation bit map. 

2 thru j Any additional sectors needed for bit map 
j+1 thru k Directory entries (8 entries per sector). 
k+1 thru i IK blocks for files and programs. 



i - surfaces * (tracks/surface) * (sectors/track) 

j = -ffi/^'"1^^2->TA-2046' .i- 2 ■^J-'^r((i/^ ^i^i^)/2i)^g) 
k = directory size j^^^^^^ ■4-9' 
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SYSTEM FILES 



E*l Hie System Disk 



The OASIS system requires a system disk to operate. The system disk is always the 
disk currently attached as the "S" disk and normally is the disk the system w? 
booted from. 

Frequently the system disk contains all of the commands to be used by the operator. 
However, this is not a requirement. In order for a disk to qualify as a system 
disk it must contain, as a minimum, the following files: 

SYSTEM. NUCLEUS 

SYSTEM. CSI 

SYSTEM. EXECLANG 

SYSTEM. EXECl 

SYSTEM. DEVNAMES 

SYSTEM. ERRMSG 

SYSTEM. DEVnn Device drivers (only those used) 

SYSTEM. CLASSnn Terminal class codes (only thos used) 

SYSTEM. AC COUNT If accounting is implemented 

SYSTEM. HISTORY If accounting is implemented 

SYSTEM. SPOOLER If print spooler is implemented 

As can be seen, the required files all have the file name SYSTEM. For the best 
response time of the system these files should be placed on the disk near the 
beginning. (Some systems require that the SYSTEM. NUCLEUS be immediately following 
the directory.) Accomplishing this is relatively simple: onto a cleared disk 
(IN ITDISK command) copy the SYSTEM. NUCLEUS, then copy all other SYSTEM files 
(COPYFILE SYSTEM * S = = <fd>). 

Because the SYSTEM. ACCOUNT file resides on the system disk, changing system disks* 
may cause a different set of account names to be available. For this reason it is 
generally best to have only one system disk with different data disks for the 
various applications of the computer. Sometimes this is not possible. In this 
situation, changes to the SYSTEM. ACCOUNT file on one system disk should be made to 
all system disks by using the COPY option of the ACCOUNT command. If this is not 

done, operators may become frustrated when they cannot LOGON to their account, 
thinking that somebody has restricted their access to the system when in fact 
somebody merely used a different system disk. 

NOTE: The system disk received from your OASIS distributor should be kept "virgin"^ 
make no changes to account names, privilege levels, etc., without considering the 
effect this might have on the access and support of the operating system. The user 
should always be able to return to the version of the system received to determine 
:*.i a problem is in the original system or in something he may have done to the 
-stem. 

■■■'"j3.-t3-T>le Systea Bislcs- 

nen it is necessary to have multiple system disks you should make the 
":YST214. ACCOUNT file identical on all system disks. This is easily done by using 
the COPY option of the ACCOUNT command. 

The importance of maintaining identical SYSTEM. ACCOUNT files on the various system 
disks cannot be overemphasized. If account ids are different on a system disk then 
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AFPEHDIX E: SYSTEM FILES 

the accounts will have a different set of files. It is possible that a set of 
files will be unaccessible (and their existence will not be reported) if accounts 
are irresponsibly deleted or changed. 

E.2 The SYSTEM.DEVHAMES File 

The SYSTEM. DEVNAMES file contains the acceptable names of all physical devices and 
their primary modes of operation. This is a sequential file and is maintainable by 
the user. In fact, additional names can be added to this file to create more 
meaningful synonyms to existing devices. If a device name is not in this file you 
will not be able to ATTACH a logical name to the device (except by using the 
physical device number, i.e. ATTACH A 4). 

The format of the file is simple and straightforward: one record per device name, 
each record containing the device name, device number, and mode of operation, all 
separated by a single space. 

The device name is any alphanumeric string of characters, up to eight characters in 
length, with the same limitations as file names (no embedded spa; ■, must start 
with a letter, etc). This name will be the normal method of specifying the device 
in the ATTACH command. 

The device number is the number of the device driver program to be used to service 
the device. When a device is ATTACHed this number is used to find the device 
driver program on the system disk. All device driver programs have file 
descriptions in the form: SYSTEM. DEVnn where nn is the number of the device driver. 
This number must be in the range 1 through 32 and the numbers 1 through 8 are 
reserved for disk device drivers. Care should be taken to ensure that two or more 
device drivers are not attached that service the same peripheral. This would cause 
unpredictable results. 

The mode of operation may be any combination of the following: 

D ^ Indicates the device is a disk device. 

C - Indicates that the device may be a console. 

P -• Indicates that the device is a printer. 

S - Indicates that the device uses serial I/O. 

I - Indicates that the device supports input. 

- Indicates that the device supports output • 

These codes tell the ATTACH command what options may apply to the device. For 
example a device that uses serial I/O uses the options: PO, PE, B, LF, FF, ENAB; 
printer devices use the options: L, P, 0, PP. 

It is permissible for more than one device name to have the same device number. 
These additional device names will be treated as synonyms to the first device name 
that uses the number. 

Disk device name records in this file contain additional information: the disk 
devices that share the disk driver. Normally a disk controller and the disk driver 
program control and communicate with up to four disk drives. To indicate to the 
ATTACH program that only one disk driver need be loaded for all of the disks that 
share this driver the ATTACH program needs to know exactly which disks are shared 
by the driver. 

To illustrate this file part of the standard, distributed file will be used. The 
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complete DEVUAMES file varies from system to system. 



FLOPPYl 1 D 1 


2 


3 


4 


FLOPPY 2 2 D 1 


2 


3 


4 


FL0PPY3 3 D 1 


2 


3 


4 


FLOPPY 4 4 D 1 


2 


3 


4 


PIOI 13 PIG 








LP 13 PIG 








SIOl 17 CPSIO 








SIO 17 CPSIO 








DISKl ID 1 2 


3 


4 




DISK2 2D 12 


3 


4 




DISK3 3 D 1 2 


3 


4 




DISK4 4 D 1 2 


3 


4 





As can be seen there are four disk devices: FLOPPYl, FL0PPY2, FL0PPY3, and FL0PPY4. 
These four devices have synonyms of DISKl, DISK2, DISK3, and DISK4 respectively. 
(Only the FLOPPYn names will be used when the current attachments are displayed as 
they occur first in the file.) Additionally, these four disk devices all share one 
disk driver. 

There is a serial device named SIOl with a synonym of SIO. This serial device 
supports input and output and may be attached as the console. 

There is also a parallel device named PIG with a synonym of LP. This parallel 
device supports input and output. 

S-.3 Tfee SYSTM.SKVim Files 

The files are the physical device driver programs and should be kept unless disk 
space is at a premium on the system disk and one or more device drivers are never 
used. 

E.4 the SYST^f*CL^Sim Files 

These files are the terminal class code translation tables used by the GONOUT 
device to translate cursor control commands into the proper codes required by your 
specific terminal. It is only necessary to keep the specific class code files that 
you use — the others may be deleted to make more space available on your system 
disk. 

For more information about these files refer to the appendix on "Terminal Class 
Codes" in this manual. 

3.5 The SYSTEM.EBBHSG File 

The SYSTEM. ERRMSG file contains all of the error j>, warning, and information messages 
that the system uses. This file is a direct file and cannot be maintained by the 
iditor. However ,^ a program is available to maintain this file if it is necessary 
to translate the messages to a foreign language. 

The format of this file is simple: one record per message, each record containing 
the message number and the message text, separated by one space. 

The message number is a number in the range of 1 through 255 used by the system to 
rijference the messages. 
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The message text cont.ains the message itself. Some messages contain variable 
information determined only at display time. This variable information is denoted 
by inclosing the parameter number within braces such as <1>. 

S.6 Ifee SYSTBM.ACCODiiT File 

The SYSTEM. AC COUNT file is a restricted access file required by the system if user 
accounting is to be used. Once this file has been removed (only by using the 
ACCOUNT command) from a disk there can be no user accounting while that disk is the 
system disk. 

This file contains information about the user accounts: the account names, 
passwords, and privilege levels for each account in the system* This file can only 
be accessed by certain system programs and can only be maintained by the ACCOUNT 
command when the system account is logged on. 

E.7 The ACCOUMT. HISTORY File 

The ACCOUNT. HI STORY file contains the user accounting information that was 
transferred from the SYSTEM. HISTORY file (see ACCOUNT command). This file is a 
sequential file accessible by the user for logon analysis, etc A record is added 
to the SYSTEM. HISTORY file (and later transferred to the ACCOUNT. HI STORY file) 
every time a user logs on, logs off, or boots the system. 

Each record of this file contains information dependent upon what caused it to be 
created. However, every record begins with the same format: time of creation, date 
of creation, and record type. The record type information specifies what caused 
the record to be created and what information follows: 

1 System boot ~ no further data 

2 User LOGON - followed by account name, id, and port. 
J User LOGOFF - followed by account name, id, port, 

and elapsed logon time in minutes. 

A-ll fields of information are separated from other fields by spaces- The date 
field is in standard date format: mm/dd/yy. The time field is in standard time 
rformat: hh:mm:ss« Account names always use eight positions with trailing spaces, 
if necessary. The elapsed time may have leading spaces (no leading zeros) and is 
expressed to the nearest hundredth of a minute. 

Because the ACCOUNT .HI STORY file is always replaced (not appended to) when the 
oYSTEM.HISTORY information is transferred you should probably append the file to 
>ne of your own if you wish to maintain any archive information. 

'ote 1: If your system does not support the time of day feature the time of 
:reatloB and the elapsed time fields will contain zeros. By placing zeros in the 
:^cord the file will have the same format as a file created on a system that does 
.ave the time of day feature and can be analyzed by a program that is identical on 
•oth systems. 

'ote 2: The history record creation can be turned on or off with the SET command. 

'.S User Defined Sjmmywsst File 

The user defined synonym file, referred to in the SET and SHOW commands,^ is a 
sequent ial file(s) created and maintained by the user containing the user defined 
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synonyms to commands. There may be more than one user defined synonym file in the 
system but the SET command only allows one of the files to be designated as the 
user synonym file at any one time. 

This file may have any valid name but must reside on the system disk and must have 
a file type of SYNONYM. This option of the system is not normally used but 
quite convenient in some situations. The most frequent use of this option occuxs 
when a user has access to, and utilizes, several different operating systems* In 
order to avoid confusion this user would probably create a synonym file that 
reflects the command names used by the other system(s). (The other system probably 
doesn't allow the user to define his own synonyms . ) For example, some operating 
systems use the name DIRECTRY, DIR or VTOC for the function performed by OASIS 's 
FILELIST command. In this case the user could create a synonym (using the TEXTEDIT 
or EDIT programs) for the FILELIST command of DIRECTRY with an acceptable 
abbreviation of three characters (DIR). Other commands could be treated similarly. 

The format of the user defined synonyms file is relatively simple: one record per 
synonym definition, each record containing three fields specifying the true command 
name, the synonym to the command name, and the minimum number of characters allowed 
for abbreviation of the synonym, each separated by a single space from the other 
fields. The minimum number of characters allowed for abbreviation is optional and, 
when omitted, implies that no abbreviation is allowed. 

In the above situation the synonym for the FILELIST command would look like: 

FILELIST DIRECTRY 3 
FILELIST VTOC 

E.9 the SYST^.EXSCna Files 

The SYSTEM. EXECl file is a data file used by the EXECutive language processor tr 
save the status and variables of one or more EXEC programs while another EXeI 
program or command is executing. 

In multi-user OASIS there will be more than one of these files, i.e., EXECl, EXEG2, 
etc., one for each user partition. 

This file is a direct access file with each record 512 characters in length. The 
number of records in this file determine the level of EXEC call nesting allowed by 
the system. As distributed this file contains two records which allow one EXEC 
program to call another but does not allow that second program to call another EXEC 
program. 

To expand (or decrease) the level of EXEC nesting log on to the system account, 
erase the SYSTEM. EXECnn files (be conscious of the fact that while this file is 
removed no EXECs may be executed and the system may not be booted), and create a 
new file with the filesize corresponding to the level of nesting desired. 

1.10 ISie SYSTSH.SFCX)1.$$1 File 

The SYSTEM.SP00L$$1 file is a data file used by the printer spooler and must be 
created by the user before the spooler is invoked (see chapter: "SPOOLER COMMAND"). 
This file may reside on any attached disk. Any file format is acceptable but a 
direct file is the easiest for you to create. The record length of the file is 
ignored by the spooler, only the total allocated file size is used. 
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A usable file size for the SYSTEM. SP00L$$1 file is about lOOK bytes. This size 
file will allow the system to keep about 25 pages ahead of the programs generating 
output to the printer (a full page of printing is about 70 characters x 60 lines = 
4200 characters). 

This size of a file can be created by entering the command: 

>CREATE SYSTEM SP00L$$1 fd (DIRECT REC 512 FILE 200) 
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AHSI K)sm a)i«moL 

The OASIS Operating System utilizes the American National Standards Institute 
(ANSI) standard for printer forms control for output directly to a device attached 
as a printer. 

When ANSI forms control is used (optional in the LIST command) the first character 
of each record transmitted to a printer is a forms control command. This command 
character is not printed on the printer but is translated to the codes required to 
effect the forms control desired. A record is always terminated with a carriage 
return (in BASIC this is accomplished by using no trailing semicolon in the output 
list) . 

Every record output to a printer is printed with a trailing carriage return but no 
trailing line feed. The line advance is performed by the next record's forms 
control, if desired. 

The following is a list of the control characters and their functions. 

Char Function 

1 Forms eject. 

+ No forms advance. This allows for overprinting. 
Double line advance. Creates one blank line. 
— Triple line advance. Creates two blank lines. 
other Single line advance. This is the normal mode of printing and is 

equivalent to printing without ANSI forms control except the first 

character is not printed. 
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TKSMHilAL CLASS CODES 

The terminal class code, set with the ATTACH command, informs the operating system 
what display features a console has and how to invoke them. Unfortunately terminal 
manufacturers have no standards imposed on them in this area. Therefore each 
manufacturer uses the method that he thinks is best or is easiest for the company 
to implement. 

In most systems, programs that try to utilize some of the special features that 
terminals have must be coded for the specific terminal(s). This is not necessary 
when using the OASIS system. In OASIS programs are coded using an internal set of 
codes defined below. When output ing to the console OASIS translates these codes to 
the codes required by the attached console. This provides greater flexibility and 
transportability for the programs. 

6*1 Inpleaiezitiiig New Class Codes 

If you have a terminal that you wish to use as a console but its cursor control 
requirements are not met by any of the class codes defined and distributed then you 
may implement your own class code by using the OASIS MACRO assembler. 

For details on the requirements of the SYSTEM. CL AS Snn file refer to the OASIS MACRO 
Assembler Language Reference Manual . 

5.2 Texrmliial Class Code Tables 

The tables on the following pages describe the classes implemented and distributed 
with the OASIS operating system. Each class code is defined in its respective 
SYSTEM. CLAS Snn file- 

Due to the delay between implementing a new class code and the distribution of the 
documentation there may be more class codes implemented than are listed in the 
"-.ables. Contact your distributor to determine if any new class codes have been 
implemented. 

Xatemal Tersdnal Codes 



Inunction 



JGME 

UEAR 

20$ 

,:0L 
:-.E?T 

-IGHT 



JiON 
^iLOFF 
iVON 
ll/OFF 



Cursor HOME 
Clear Screen 
End Of Screen clear 
End Of Line clear 
Cures r Left 
Cursor Right 
Cursor Up 
Cursor Down 
lursor address 
Address coding 
Underline ON 
Underline OFF 
Reverse Video ON 
Reverse Video OFF 



1 Code 


Val 1 


Function 


1 


Code 


Val 




} SOH 


1 


KON 


Keyboard ON 




EM 


25 




j FF 


12 


KOFF 


Keyboard OFF 




NAK 


21 




j CAN 


24 


PON 


Protect ON 




EOT 


4 




} ETB 


23 


POFF 


Protect OFF 




ENQ 


5 




I BS 


8 


BON 


Highlight on 




GS 


29 




j ACK 


6 


BOFF 


Highlight off 




RS 


30 




1 SUB 


26 


EU 


Erase Unprotected 




FS 


28 




J LF 


10 


IL 


Insert Line 




DCl 


17 




I DLE.c 


,1 16 


IC 


Insert Character 




DC3 


19 




j Abs 




DL 


Delete Line 




DC2 


18 




1 VT 


11 


DC 


Delete Character 




DC4 


20 




j SYN 


22 


FON 


Format ON 




STX 


2 




i SO 


14 


FOFF 


Format OFF 




ETX 


3 




1 SI 


15 
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In the following tables abbreviations are used which are defined as: 

N/A Indicates that the function is not available on the terminal. 

Simulated Indicates that the function is not available on the terminal but i 
simulated by the operating system. For example, EOS is simulated b^ 
outputting spaces to the end of the screen and then re~positioning to the 
same screen location. 

Standard Indicates that the line and column number is coded using the ASCII 
displayable character sequence- Value 1 = space, value 2 = "i", etc. 

Special Indicates that the bias for the line number is different than for the 
column number. 

Abs Indicates that the line and column number is coded using the absolute 
values for the line and column number, base zero. Value 1 is a binary 0, 
value 2 is a binary 1, etc. 

ASCII Indicates that the line and column number is coded using the ASCII 
character representation of the value. Value 1 is "1", value 2 is "2", 
value 15 is "15", etc. 

* The functions KON and KOFF are always simulated by the operating system. 

Some class code files perform input translation as well as output translation. 
When this is the case the table following the class code table defines the 
character values (in hexadecimal) translated. This input translation facilitates a 
consistent interface for arrow keys, etc. 
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Tensdnal Class Codes 1 — 4 



1 FILE 


CLASS 1 


CLASS 2 


CLASS 3 


CLASS 4 1 




beehive 100 


ADDS 580 


ADM 3A 


SOROC IQ 1 


1 Func 


■ 


Envoy 






jHOME 


esc,"h" 


DLE,0,VT," " 


RS 


RS 1 


1 CLEAR 


ESC,"X", 

esc,"e" 


FF 


SUB 


ESC,"*" 1 


|EOS 


ESC, "J" 


Simulated 


Simulated 


ESC,"Y" 1 


|EOL 


esc,"k" 


Simulated 


Simulated 


ESC,"T" j 


Jleft 


esc,"d" 


NAK 


BS 


BS 1 


j RIGHT 


esc/'c" 


ACK 


FF 


FF 1 


jUP 


esc, "A" 


SUB 


VT 


VT 1 


IDOWN 


LF 


LF 


LF 


LF 1 


|X,Y 


ESC,"F",l,c 


DLE,l,VT,c 


ESC,"=",l,c 


ESC,"=",l,c 1 


iBias 


Standard 


Standard 


Standard 


Standard | 


jIL 


N/A 


N/A 


N/A 


N/A 1 


|IC 


N/A 


N/A 


N/A 


N/A 1 


|DL 


N/A 


N/A 


N/A 


N/A j 


JDC 


N/A 


N/A 


N/A 


N/A 1 


|EU 


ESC,"E" 


N/A 


N/A 


ESC,"+" 1 


Ikon * 










(koff * 










JPON 


ESC,"}" 


N/A 


N/A 


ESC,")" 1 


1 poff 


ESC,"[" 


N/A 


N/A 


ESC,"(" j 


JFON 


ESC,"W" 


N/A 


N/A 


ESC,"&" 1 


JFOFF 


ESC,"X" 


N/A 


N/A 


ESC,"'" 1 


|BON 


ESC,"1" 


N/A 


N/A 


N/A j 


jBOFF 


ESC,"m" 


N/A 


N/A 


N/A j 


lULON 


N/A 


N/A 


N/A 


N/A 1 


JULOFF 


N/A 


N/A 


N/A 


N/A 1 


JRVON 


N/A 


N/A 


N/A 


N/A 1 


jRVOFF 


[ N/A 


N/A 


N/A 


I N/A 1 



IiDp«,t Translation 

From To | From To | From To 



From 



To 



OBH 


lAH 


OCH 


06H 


lEH 


OIH 
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I I 

[Func I 



Terminal Class Codes 5—8 



CLASS 5 
V D M 



jHOME 
I CLEAR 
jEOS 
|EOL 
I LEFT 
j RIGHT 
[UP 
I DOWN 
|X,Y 

I 
(Bias 



( SOH 

j FF 

I CAN 

j ETB 

j BS 

I ACK 

I SUB 

I LF 

j DLE,c,l 

I 

I Abs 



CLASS 6 
HAZELTINE 
1400/1500 

"""'^DCa 

"■^",FS 

"""'.CAN 

•"^",SI 

BS 

DLE 

""-"jFF 

LF 

"'^",DCl,c,l 

Special 



CLASS 7 
TELEVIDEO 
912/920 

RS 

ESC,"*" 

ESC,"Y" 

ESC,"T" 

BS 

FF 

VT 

LF 

ESC,"=",l,c 

Standard 



CLASS 8 } 

Perkin-Elmer j 

Fox I 

ESC,"H" I 

ESC,"K" I 

ESC, "J" i 

ESC, "I" I 

ESC,"D" j 

ESC,"C" j 

ESC, "A" j 

LF j 

ESC,"X",1, j 

ESC,"Y",c 1 

Standard I 



ilL 

lie 

JDL 

I DC 

|EU 

[KON * 

JKOFF * 

fPON 

IPOFF 

JFON 

[FOFF 

[BON 

jBOFF 

JULON 

{ULOFF 

fHVOIi 

fHVOFF 



DCl 
DC3 
DC2 
DC 4 
FS 



EOT 

ENQ 

STX 

ETX 

GS 

RS 

VT 

SYN 

SO 

SI 



"'-",SUB 
N/A 

"^",DC3 
N/A 
"-".GS 






ESC,"E" 
ESC,"Q" 
ESC,"R" 
ESC,"W" 
N/A 



,EM 


ESC,"&" 


,US 


ESC,"'" 


N/A 


ESC,")" 


N/A 


ESC,"(" 


N/A 


[ ESC,"''" 


N/A 


ESC,"q" 


N/A 


ESC,"1" 


N/A 


1 ESC,"m" 


N/A 


ESC,"j" 


N/A 


1 ESC,"k" 



N/A 
N/A 
N/A 
N/A 
N/A 



N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 

N/A 
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TemodLnal Class Codes 9 ~ 12 



1 FILE 


CLASS9 


CLASSIC 


CLASS 11 


CLASS 12 j 


1 


Perkin-Elmer 


A N S I 


Infoton 100 


V G 1 


iFunc 


Bantom 


Heath HI 9 




Flashwriter j 




===========5=:=:== 


=========!=: s=s===s= 


================ 


============== j 


IHOME 


ESC,"H" 


ESC,"[H" 


ESC,"H" 


SOH 1 


CLEAR 
1 


ESC,"K" 


ESC,"[H", 
ESC,"[2J" 


FF 


FF 1 


|EOS 


Simulated 


ESC, "[J" 


ESC, "J" 


cm 1 


EOL 


Simulated 


ESC , " [K" 


ESC,"K" 


ETB 1 


[LEFT 


ESC,"D" 


ESC,"[D'' 


BS 


BS i 


1 RIGHT 


ESC,"C" 


ESC,"[C" 


ESC,"C" 


ACK 1 


|UP 


ESC, "A" 


ESC, "[A" 


ESC, "A" 


su: j 


[DOWN 


LF 


LF 


LF 


LF 1 


|X,Y 
1 


ESC,"X",1, 
ESC,"Y",c 


ESC,"[M, 

M.II IITJII 


ESC,"f",c,l 


DLE,c,l 1 


[Bias 




Standard 


ASCII 


Standard 


Abs 1 


IIL 


N/A 


ESC,"[1L" 


ESC,"L" 


DCl 1 


IC 


N/A 


N/A 


ESC,"<a" 


DCS 


DL 


N/A 


ESC,"[1M" 


ESC,"M" 


DC2 


DC 


N/A 


ESC," [IP" 


ESC,"P" 


DC4 


EU 


N/A 


ESC,"[H", 
ESC,"[2J" 


ESC,"H", 
ESC, "J" 


FS 


KON * 










KOFF * 










PON 


N/A 


N/A 


ESC, "4" 


EOT 


POFF 


N/A 


N/A 


ESC, "3" 


ENQ 


FON 


N/A 


N/A 




STX 


FOFF 


N/A 


N/A 




ETX 


BON 


N/A 


N/A 


N/A 


GS 


BOFF 


N/A 


N/A 


N/A 


RS 


ULON 


N/A 


N/A 


N/A 


VT 


JULOFF 


N/A 


N/A 


N/A 


SYN 1 


[RVON 


N/A 


ESC, "[7m" 


ESC,"b" 


1 SO j 


IRVOFF 


N/A 


ESC,"[m" 


ESC/'a" 


1 SI 1 






From 



iuipiit TraBsla 

To I From To 



I IBH, 

1 IBH, 

I IBH, 

I IBH, 

I IBH, 

I IBH, 

I IBH, 

I IBH, 

I IBH, 

I IBH, 

I IBH, 

I IBH, 



'S' OIH 
"T" a2H 



»»U" 

Mytl 

»1pl» 
ll/-|H 



Q3E 
04H 
05H 
50H 
51H 
43H 
"[A" lAH 
"[B" OAH 
"[C" 06H 
"[D" 08H 



Q 
"R" 






From 



To I From To 1 



j lAH 

I 12H 

I 15H 

I 17H 

i 02H 

I 7EH 



06H I 
lOH I 
lAH i 
08H i 
OAH I 
lAH f 
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Tenalnal Class Codes 13 - 20 



i FILE 

t : ■ 

|Func 

[HOME 

[CLEAR 

lEOS 

[EOL 

[LEFT 

I RIGHT 

[UP 

[DOWN 

|X,Y 

I Bias 



CLASS 13 

TRS~80 II 

V D M 

SOH 

FF 

CAN 

ETB 

BS 

ACK 

SUB 

LF 

DLEjCjl 

Abs 



CLASS 14 

Elbit VDU 

1920 

ESC, 0,0 

CAN, ESC, 0,0 

DC4 

SYN 

BS 

NAK 

SUB 

LF 

ESC,l,c 

Special 



CLASS 15 
ADDS 
Regent 20 

SOH 

FF 

Simulated 

ESC,"K" 

NAK 

ACK 

SUB 

LF 

ESC,"Y",l,c 

Standard 



CLASS 20 I 

Informer | 

304 I 

ESC,"H" j 

ESC,"Z" I 

ESC,"/" 1 

ESC,"Q" I 

BS I 

ESC,"C" I 

ESC, "A" { 

LF j 

ESC,"Y",l,c j 

Standard I 



|IL 
|IC 

|DL 
JDC 

jEU 

Ikon * 

JKOFF * 
JPON 
JPOFF 
IFON 



|;BON 

JBOFF 

JULON 

[ULOFF 

JRVON 

{RVOFF 



N/A 
N/A 
N/A 
N/A 

N/A 



N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 



SO 
SI 



N/A 
N/A 
N/A 
N/A 
N/A 



N/A 

N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 



N/A 
N/A 

N/A 
N/A 
N/A 



N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 



N/A 
ESC,"[" 

N/A 
ESC,"\" 
ESC,"N" 



ESG,"W" 
ESC,"X" 
ESC,"E" 
ESG,"F" 
ESC,"L" 
ESC,"M" 
N/A 
N/A 
ESC, "J" 
ESC,"K" 



liipnt Trjamslation 

From To | From To I From To 

I 15H 08H 



From 



To [ 





IGH 


08H 




IDH 


06H 




lEH 


lAH 




IFH 


OAH 




OOH 


5CH 
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Terradnal Class Codes 21-24 



1 FILE 1 


CLASS21 1 


CLASS 22 1 


CLASS 23 i 


CLASS 24 1 




Data Media | 


IBM 


SD 


SYSTEMS i 


Intertube I 


1 Func 1 


1 


3101 ! 


VDB 8024 j 




JHOME 


EM 


ESC,"H" 


SOH 




SOH 1 


(CLEAR 


FF 


ESC,"L" 


FF 




FF { 


|EOS 


VT 


ESC, "J" 


CAN 




ESC,k j 


J€OL 


GS 


ESC, "I" 


ETB 




ESC,K 1 


ILEFT 


BS 


ESC,"D" 


BS 




NAK 1 


JRIGHT 


FS 


ESC,"C" 


ACK 




ACK j 


jUP 


US 


ESC, "A" 


SUB 




SUB 1 


IDOWN 


LF 


LF 


LF 




LF 1 


|X,Y 


RS,c,l 


ESC,"Y",l,c 


ESC 


"=" c 1 


ESC,"Y",l,c 1 


JBias 


Standard 


Standard 


Standard 


Standard | 


|IL 


N/A 


ESC,"N" 




N/A 


N/A 1 


lie 


N/A 


ESC,"P" 




N/A 


N/A 1 


jDL 


N/A 


ESC,"0" 




N/A 


N/A 1 


|DC 


N/A 


ESC,"Q" 




N/A 


N/A J 


jEU 


N/A 


N/A 




N/A 


ESC,"G" 1 


JKON * 












JKOFF * 










1 


{PON 


EOT 


N/A 




N/A 


special * j 


(POFF 


CAN 


N/A 




N/A 


special * | 


|FON 


N/A 


N/A 




N/A 


' N/A 1 


JFOFF 


N/A 


1 N/A 




N/A 


N/A { 


Jbon 


N/A 


1 N/A 


1 GS 




special * j 


jBOFF 


N/A 


1 N/A 


RS 




' special * j 


jULON 


1 N/A 


N/A 


I ?T 




1 N/A j 


JULOFF 


1 N/A 


1 N/A 


i SYN 




1 N/A j 


JRVON 


[ N/A 


I N/A 


SO 




[ special * { 


{RVOFF 


1 N/A 


N/A 


1 SI 




special * j 



I From To J 



Input 


Trasaslatlon 








:=:=:s:s5sss 


sssssssssss: 


ssssssisssss: 


sssssszsssssssa 


ssssssssssssssssssstsis:: 


From 


To 


} From 


To 1 


From 


To 


SSSSSSKS 


sssssssssssaz 


ssssssssasssass 


SEsssSB'Ssssasssssssatssssa:: 


ss:a:s:3a 






1 OBH 


lAH i 


15H 


08H 






1 19H 


09H j 







* The output codes for these capabilities are inter dependant. 
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APPEHDIX H 



PRIVILBeK LEVELS 



The OASIS operating system supports privileged access to programs. Privileged 
access means that each program is assigned a privilege value. Access to a specific 
program is allowed only if the current user has a privilege level equal to or 
greater than the privilege value of the program. 



An attempt to access a program with a privilege value 
level will be rejected with no error message. 



higher than your privilege 



The current privilege level may be lowered by using the SET PRIV command. The 
current privilege level may be displayed by using the SHOW PRIV command. The 
current privilege level is a SYSGENable function but this only has meaning when the 
user accounting feature is removed. 



The following table lists the OASIS 
with them, as they are distributed. 



commands and the privilege value associated 






5 ACCOUNT 





FILELIST 


3 MEMTEST 


3 


SECTOR 


ASSIGN 


4 


FILT8080 


MOUNT 


1 


SEND 


ATTACH 


5 


FORCE 


MSG 


1 


SET 


3 BACKUP 


2 


GETFILE 


3 OWNERCHG 


3 


SHARE 


2 BASCONV 


3 


INITDISK 


3 PATCH 





SHOW 


2 BASIC 


4 


INTELHEX 


PEEK 


/ 


SPOOLER 


3 CHANGE 


3 


KILL 


1 RECEIVE 


5 


START 


1 COPYFILE 


2 


LINK 


3 RECOVER 





STATE 


1 CREATE 





LIST 


4 RELOCATE 


5 


STOP 


4 DEBUG 


5 


LOAD 


1 RENAME 


5 


SYSGEN 


2 DUMPDISK 





LOGOFF 


3 REPAIR 


2 


TEXTEDIT 


2 EDIT 





LOGON 


RUN 


1 


TERMINAL 


1 ERASE 


4 


MACRO 


SCHEDULE 


5 


UNLOAD 


2 FILECONV 





MAILBOX 


SCRIPT 


3 


VERIFY 



The privilege level of a program (C0MMA13D) may be changed to a different value by 
using the CHANGE command. 

Note 1: Because the privilege level of the system cannot be raised by any program 
you should take care to always maintain at least one system disk that has the 
highest privilege level that you will ever need. This is usually accoi5)lished by 
never making any changes to the copy of the system oti the distibution disk. 

Note 2: Do not raise the privilege level of the LOGON and LOGOFF commands"— you 
would make it very difficult to change from one account to another. Privilege 
values and levels may be in the range of to 5- The following conventions were 
used to determine the privilege values of the system programs: 

Non-file modifying system utilities, RUN version of BASIC* 

1 File modifying system utilities. 

2 High level language programming utilities- 

3 Maintenance utilities (i.e. PATCH). 

4 Assen4>ly level language programming utilities. 

5 System management. 
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I.l . Bisk. Errors ' 

All disk errors are displayed on the console after the disk retry count has be€ 
exhausted. The format of the disk error message is: 

DdLsk <fd>(<#>) <ajes»age> <cyl>,<&ead>,<sect> 

Where: 

<fd> Indicates the logical disk label (S, A, B, etc). 

<#> Indicates the physical disk number that was attached to the logical disk 
label. 

<message> Indicates the specific disk error message. 

<cyl> Indicates the cylinder number of the disk that the error occured on. This 
number is in decimal. 

<head> Indicates the head or surface number of the cylinder that the error 
occured on. This number is in decimal. 

<sect> Indicates the physical sector number within the cylinder of the disk 
error. This number is displayed in decimal. 

When a disk error occurs the system automatically retries the operation until it is 
successful or until the retry count is exhaused. If it is successful no indication 
of an error is given to the operator (except a slight delay in processing). When 
the operation is not successful and the retry count is exhausted an error message 
is displayed on the console and the system waits for a response from the operator. 

When a disk error message is displayed on the console the operator must type a key 
for processing to continue. Valid responses by the operator include: 

R Retry the operation again 

I Ignore the operation and continue processing as if the operation was 
successful. This response may cause more errors than intended. In 
general, only use the I response for read type operations and when 
you are sure that the information will not be used for a write 
operation following. 

Q Quit the operation and return control to the Command String 
Interpreter. 

M Jf^rform a MOUNT for the error disk. This response is only valid when 
th'i^?' error message is 'Disk Changed'. 

Caution should be exercised in the use of the I and Q responses. The actual 
results of this response will be dependent upon the specific operation being 
performed. However, the I response is invaluable when performing a disk backup or 
similar operation. Before using the I response you should try the R response 
several times to insure that the data is truly unrecoverable. 
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The integrity of information written to or read from a disk is verified by use of a 
checksum or CRC value. CRC is the initials of the term "Cyclic Redundancy Check" 
and refers to the process of generating a value using an algorithm that relates the 
value generated to the information that it was generated from. This is a 
reasonably accurate and efficient method of verifying read/write integrity. When 
information is to be written to the disk a CRC value is generated and written along 
with the data* When the information is read back from the disk a CRC value is 
generated for the information read. If the CRC of the data read is not the same as 
the CRC read back with the data then there is an error. This error may be related 
to the data or it may be that the CRC value read from the disk is in error. 

The following disk error messages are described in alphabetic order. The number 
preceding the error message is the internal error number. 

Disk Error Messages 

9 Header Error - The sector or track address read from the disk does not 
correspond to its checksum read from the disk. Enter a carriage return 
to retry the operation. 

4 Data CRC Error - The data read from the disk does not correspond to its 
checksum read from the disk. Enter a carriage return to retry the 
operation. 

6 Disk Changed - The disk ID on the disk does not match the ID saved in 
memory. Mount the correct disk, unload this disk, or enter an M. 

5 Invalid Paraiaeters - The sector number to be read/written is invalid 
(negative or greater than maximum). The data and/or program is 
invalid. This error usually only occurs during a read of a sequential 
file, indicating that the link address to the next block of the file is 
invalid. The only method of exiting from this error condition is the I 
or Q response. 

3 Hot Initialized - Addresses and data on the disk cannot be read; system 
assumes the disk has not been formatted. To recover from this error 
you must quit and initialize the disk. If the error is occuring on 
many disks that are actually initialized then the head alignment of the 
disk drive should be suspected. 

1 Hot Readj - Disk not loaded, not rotating at proper speed, or is 
mounted off center* Unload and reload disk slowly. 

7 Sector Hot Found -• Sector address is invalid or doesn't match its 
checksum. If the operation is a write to the disk then enter a 
carriage return to retry the operation - usually this will c^-cover from 
the error. If the operation is a read, then you will probably have to 
cancel the operation and either restore the data from the hacrjip disk 
(initialize this disk first) or try to recover the data usine the DEBUG 
program (if available). The DEBUG program, if used improperly, may 
cause more loss of data than recovered! 

8 Track Not Found - Track address is invalid or doesn't match it& 
checksum. Retry the operation. If not recoverable restore from your 
backup disk. 
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2 Write Fxrotecteii - Disk is physically or logically write protected. 
The following errors may occur during systeiQ start up (i>oot): 

Disk Error: ma Indicates one of the above errors. The disk error 
message cannot be displayed because the system cannot be read into 
memory. Usually the error can be resolved by reloading the disk 
slowly, making sure that it is seated properly, etc. 

Mot Foimd: "SYStm-SHJCaLEOS" Indicates that a non-system disk is in the 
system drive. 

Hot Fomadz "SYSTSM.SXSei*" Indicates that the EXECl file is not on the 
system disk. This file must exist in order to couple te the system 
start up. 

Not Found: "SYST®I»CSI** Indicates that a non-system disk is in the 
system drive. 

Hot FoiHid: "SYSTBM.ESBJKG" Indicates that a non-system disk is in the 
system drive. 

1.2 Systeai Measages 

The following, is a listing of the SYSTEM. ERRMSG file as distributed. The messages 
that contain numbers surrounded by braces {> indicate that the message contains 
variable information that is determined only at the time the message is displayed. 
For exan^le, message number 42 is used by the STATE command to display the number 
of files found and the number of disk blocks used by those files. 

The messages are fairly self explanatory. More detail about the specilMc messagtl 
cannot be given because the messages are almost totally independent of the 
programs. In general, if a message is displayed that you do not know how to 
interpret then read the section or manual describing the program that was executing 
when the message was displayed. 

ITumber Text 

[11 Syntax error. 

[21 File name missing. 

[3] File type missing. 

[41 Drive code missing. 

[5] Disk not attached. 

[6] Disk not mounted. 

[7] Invalid option. 

[8] File not found. 

[93 Disk full. 

[10] Directory full. 

[11 J Invalid file name. 

[123 Invalid drive code. 

'133 File "<i>«(2>" not found. 

[14] "{1>" is not recognizable. 

[15] "{!>" is an invalid numeric. 

[16] Expecting "{i>", found "<2}". 

[17] Expecting "{1}", found end-of-line. 

[18] Protected file. 
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[193 Insufficient privilege. 

[20] Incorrect serial number. 

[21] Expecting end-of-line, found "{1}". 

[22] Required parameter missing. 

[23] Must be "ON" or "OFF". 

[24] Incorrect format, should be "{1}". 

[25] Cannot detach the CONSOLE. 

[26] Invalid record in "<1>.{ 2 >". 

[27] Cannot attach to an output only device. 

[28] Cannot attach to an input only device. 

[29] Can only attach to a random storage device. 

[30] Cannot attach to a random storage device. 

[31] Cannot detach the System disk. 

[32] Undefined logical device. 

[33] Undefined physical device. 

[34] Must be sequential organization. 

[35] File already exists. 

[36] Organization code is missing. 

[37] Missing option: "<!}". 

[38] COMM device is not attached. 

[39] Device is not attached. 

[40] File channel is not assigned. 

[41] No files found. 

[42] <1} file(s), <2> block(s). 

[43] Must have at least two disks attached. 

[44] Source and destination drives cannot be the same. 

[45] No files erased. 

[46] {1} file(s) erased, {2} block(s) recovered. 

[47] Source and destination do not have the same capacity. 

[48] Receiver disconnected. 

[491 Receiver timed out. 

[50] Too many serial numbers. 

[51] Load module contains unresolved external references. 

[52] Cannot mix ABS with REL or COM modules. 

[53] Cannot have multiple ABS modules. 

[54] Symbol table overflow. 

[55] Unexpected end-of-file« 

[56] Program has no PABs! 

[57] Only private files may be shared. 

[58] SYSTEM. ACCOUNT file is missing. 

[59] System account cannot share files. 

[60] Incorrect password. 

[61] Account not found. 

[62] File "{1}.<2}:{3}" already exists on account "{4}". 

[63] Spooler is not initialized. 

[64] Spooler is -busy printing. 

[65] Spooler is waiting for work. 

[66] Spooler is waiting for printer. 

[671 Spooler is suspended. 

[68] Insufficient Memory. 

[69] Device is attached to partition^ {1). 

[70] Invalid partition number. 

[71] Partition not allocated. 

[72] Partition is still active. 

[73] Partition is not active. - 

[74] Can't send message to your own partition. 
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[75 
[76 
[77 
[78 

[79 
[80 
[81 
[82 
[83 
[84 
[85 
[86 
[87 
[88 
[89 
[90 
[91 
[92 
[93 
[94 
[95 
[96 



User is not logged on. 

User is not receiving messages. 

Must be single user mode or private disk volume. 

Must be single user mode. 

Can only execute from System account. 

No files changed. 

File "{1}.{2}:<3}" is now owned by account "{4>". 

Partition size is too small. 

Partition size is too large. 

Partition must be one larger than current top partitiono 

Can only modify top partition. 

Next lower parrtition is still active. 

Module {1} is not loaded. 

Module {1> is already loaded. 

Too many re-entrant modules. 

"{l>-<2}:{3>" filed. 

"{1>.<2>:<3>" saved. 

** Partition has been stopped! ** 

That account is in use by partition {!}• 

Cannot PEEK at yourself 1 

Cannot FORCE yourself i 

All partitions are active. 



Other messages may be added in the future as the need arises. 
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Dec Hex Oct Binary Display Key Definition 



Special Use 






00 


000 


0000 


0000 




CTRL/(a 


NUL 


Filler 


1 


01 


001 


0000 


0001 


Home 


CTRL /A 


SOH 


Start of Heading 


2 


02 


002 


0000 


0010 


FON 


CTRL/B 


STX 


Start of Text 


3 


03 


003 


0000 


0011 


FOFF 


CTRL/C 


ETX 


End of Text 


4 


04 


004 


0000 


0100 


PON 


CTRL/D 


EOT 


End Of Transmission 


5 


05 


005 


0000 


0101 


POFF 


CTRL/E 


ENQ 


Enquiry 


6 


06 


006 


0000 


Olio 


Right CTRL/F 


ACK 


Acknowledge 


7 


07 


007 


0000 


0111 


Bell 


CTRL/G 


BEL 


Bell 


8 


08 


010 


0000 


1000 


BS 


CTRL/H 


BS 


Backspace 


9 


09 


Oil 


0000 


1001 


TAB 


CTRL /I 


HT 


Horizontal tabulation 


10 


OA 


012 


0000 


1010 


LF 


CTRL /J 


LF 


Line Feed 


11 


OB 


013 


0000 


1011 




CTRL/K 


VT 


Vertical tabulation 


12 


OC 


014 


0000 


1100 CLEAR CTRL/L 


FF 


Form Feed 


13 


OD 


015 


0000 


1101 


CR 


CTRL/M 


CR 


Carriage Return 


14 


OE 


016 


0000 


1110 




CTRL/N 


SO 


Shift Out 


15 


OF 


017 


0000 


ill! 




CTRL/O 


SI 


Shift In 


16 


10 


020 


0001 


0000 




CTRL/P 


DLE 


Data Link Escape Cursor address 


17 


11 


021 


0001 


0001 




CTRL/Q 


DC^l 


Device Control 1 


18 


12 


022 


0001 


0010 




CTRL/R 


DC2 


Device Control 2 


19 


13 


023 


0001 


0011 




CTRL/S 


DC3 


Device Control 3 


20 


14 


024 


0001 


0100 




CTRL/T 


DC4 


Device Control 4 


21 


15 


025 


0001 


0101 


KOFF 


CTRL/U 


NAK 


Negative Acknowledge 


22 


16 


026 


0001 


OHO 




CTRL/V 


SYN 


Synchronous Idle 


23 


17 


027 


0001 


0111 


EOL 


CTRL/W 


ETB 


End of Transmission Block 


24 


18 


030 


0001 


1000 


EOS 


CTRL/X 


CAN 


Cancel 


25 


19 


031 


0001 


1001 


KON 


CTRL/Y 


EM 


End of Medium 


26 


lA 


032 


0001 


1010 


Up 


CTRL/Z 


SUB 


Substitute 


27 


IB 


033 


0001 


1011 




CTRL/[ 


ESC 


Escape 


28 


IC 


034 


0001 


1100 




CTRL/\ 


FS 


File separator 


29 


ID 


035 


0001 


1101 


BON 


CTRL/ 3 


GS 


Group separator 


30 


IE 


036 


0001 


1110 


BOFF 


CIRir 


RS 


Record separator 


31 


IF 


037 


0001 


nil 




CTRL/_ 


US 


Unit separator 
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Dec Hex Oct Binary Display Key Definition 



Special Use 



32 
33 
34 
35 
36 
37 
38 

39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 

M 
57 

sa 

59 
60 
61 
62 
63 



20 040 

21 041 

22 042 

23 043 

24 044 

25 045 

26 046 

27 047 

28 050 

29 051 
2A 052 
2B 053 
2C 054 
2D 055 
2E 056 
2F 057 

30 060 

31 061 

32 062 

33 063 

34 064 

35 065 

36 066 

37 067 

38 070 

39 071 
3A 072 
3fi 073 
3€ 074 
3D 075 
3E 076 
3F 077 



0010 
0010 
0010 
0010 
0010 
0010 
0010 
0010 
0010 
0010 
0010 
0010 
0010 
0010 
0010 
0010 
0011 
0011 
0011 
0011 
0011 
0011 
0011 
0011 
0011 
0011 
0011 
0011 
0011 
0011 
0011 
0011 



0000 
0001 ! 

0010 " 

0011 # 

0100 $ 

0101 % 
OHO & 
0111 ' 

1000 ( 

1001 ) 

1010 * 

1011 + 

1100 , 

1101 - 

1110 . 

1111 / 

0000 



LINK prompt 



0001 
0010 
0011 
0100 
0101 
Olio 
OIU 

1000 8 

1001 9 

1010 : 

1011 ; 

1100 < 

1101 = 

1110 > 

1111 ? 



COPYFILE prompt 
EDIT prompt 



space bar SP - Space 
Exclamation mark 
Double quote 
Number symbol 
Dollar symbol 

Percent symbol 
And - Anpersand 
Single quote 
Left parenthesis 
Right parenthesis 
Asterisk 
Plus symbol 
Comma 

Minus/Hyphen symbol BASIC prompt 
Period /Decimal point 
Divide symbol - Slash/Slant 
Zero 
One 

Two 

Three 

Four 

Five 

Six 

Seven 

Eight 

Nine 

Colon EXEC pxomgt 

Semicolon €SX comsaent 

Less than symbol - Left carrot 
Equal symbol DEBUG prompt 
Greater than/Right carrot CSI prompt 
Question mark 
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Dec 


Hex 


Oct 


Binary Displc 


ly Key 


Definition Special Use 


s===r= 


===== 


===== 


====== 


====== 


===== 


======= 


=========:===== =s=s: ====:==: =;==ss:s:s:==^a=: 


64 


40 


100 


0100 


0000 


@ 


Q 


At sign ~ Atpersand 


65 


41 


101 


0100 


0001 


A 


A 




66 


42 


102 


0100 


0010 


B 


B 




67 


43 


103 


0100 


0011 


c 


C 




68 


44 


104 


0100 


0100 


D 


D 




69 


45 


105 


0100 


0101 


E 


E 




70 


46 


106 


0100 


Olio 


F 


F 




71 


47 


107 


0100 


0111 


G 


G 




72 


48 


110 


0100 


1000 


H 


H 




73 


49 


111 


0100 


1001 


I 


I 




74 


4A 


112 


0100 


1010 


J 


J 




75 


4B 


113 


0100 


1011 


K 


K 




76 


4C 


114 


0100 


1100 


L 


L 




77 


4D 


115 


0100 


1101 


M 


M 




78 


4E 


116 


0100 


1110 


N 


N 




79 


4F 


117 


0100 


1111 










80 


50 


120 


0101 


0000 


p 


P 




81 


51 


121 


0101 


0001 


Q 


Q 




82 


52 


122 


0101 


0010 


R 


R 




83 


53 


123 


0101 


0011 


s 


S 




84 


54 


124 


0101 


0100 


T 


T 




85 


55 


125 


0101 


0101 


u 


U 




86 


56 


126 


0101 


Olio 


V 


V 




87 


57 


127 


0101 


0111 


w 


W 




88 


58 


130 


0101 


1000 


X 


X 




89 


59 


131 


0101 


1001 


Y 


Y 




90 


5A 


132 


0101 


1010 


z 


Z 




91 


5B 


133 


0101 


1011 


[ 


[ 


Left bracket 


92 


5C 


134 


0101 


1100 \ 


\ 


Back slash /slant PATCH promp 


93 


5D 


135 


0101 


1101 


3 


] 


Right bracket 


94 


5E 


136 


0101 


1110 


*** 


^ 


ASCII up arrow - circumflex 


95 


5F 


137 


0101 


1111 


— 


— 


Underscore 
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Dec : 


Hex Oct Binary Display Key 


Definition 


Special Use 


===s = 


=:=:=5==ss==rS5===S= 


!=:ss=====s:s==r= 


==:s=:=i=:=s. 


====== =:=s=s=r===:-==:==s=!== 


=s==:==;=:==:=====^sss=:s=s= 


96 


60 140 0110 


0000 " 


> 


Back quote 




97 


61 141 0110 


0001 a 


a 






98 


62 142 0110 


0010 b 


b 






99 


63 143 0110 


0011 c 


c 






100 


64 144 0110 


0100 d 


d 






101 


65 145 0110 


0101 e 


e 






102 


66 146 0110 


OLIO f 


f 






103 


67 147 0110 


0111 g 


8 






104 


68 150 0110 


1000 h 


h 






105 


69 151 0110 


1001 i 


i 






106 


6A 152 0110 


1010 j 


j 






107 


6B 153 0110 


1011 k 


k 






108 


6C 154 0110 


1100 1 


1 






109 


6D 155 0110 


1101 m 


m 






110 


6E 156 OHO 


1110 n 


n 






111 


6F 157 0110 


nil o 









112 


70 160 0111 


0000 p 


P 






113 


71 161 0111 


0001 q 


q 






lU 


72 162 0111 


0010 r 


r 






115 


73 163 0111 


0011 s 


s 






116 


74 164 0111 


0100 t 


t 






117 


75 165 0111 


0101 u 


u . 






118 


76 166 0111 


0110 V 


V 






119 


77 167 0111 


0111 w 


w 






120 


78 170 0111 


lOQQ X 


X 






121 


79 171 0111 


1001 J 


y 






122 


7A 172 0111 


1010 z 


?:- ' 






123 


7B 173 0111 


1011 { 


< 


Left brace 




124 


7C 174 0111 


1100 1 


I 


Vertical bar 




125 


71) 175 0111 


UOl } 


y 


Right brace 




126 


7E 176 0111 


1110 "- 


"^ 


Tilde 




127 


7F 177 0111 


1111 DEL 


DEL 


RUBOUT 
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Reader's Comsents 

Name ^ . ©ate. ^ /_ /__ ■ . 

■ Organization ^ ________ 

. Street [ ^ _^ . . ;.:..... .. 

City . State , Zip . 

Name of manual: _ . ' 

Did you find errors in this manual? If so, specify with page number. 



Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 



Is there sufficient documentation on associated system prograc^ required for use of 

the software described in this manual? If not, what material is missing and where 
should it be placed? . 



Indicate the type of user /reader that ^^ou most nearly represent: 

Assembly language programmer 

Higher-level language programmer (BASIC, FORTRAN,, etc.) 

Occasional programmer (experienced) 
User with little prograiitfDiing experience 
Student programmer 
'. Non-programmer interested in computer concepts and capabilities 
_^ Data entry operator 

Hail to: OASIS Documentation 

Phase One Systems, Inc. 
7700 Edgewater Drive #830 
Oakland^ CA 94621 



